Initial commit with README

2018-11-07 11:22:20 +09:00
parent 586ea60238
commit 08ef049e76
4 changed files with 164 additions and 2 deletions
--- a/README.md
+++ b/README.md
@@ -1,2 +1,34 @@
-# Gigabyte-GA-B75M-D3H-rev1.1-SSDT-UIAC
-Custom SSDT UIAC for the Gigabyte GA-B75M-D3H rev1.1 motherboard
+# Gigabyte GA-B75M-D3H rev1.1 SSDT-UIAC
+Custom SSDT UIAC for the Gigabyte GA-B75M-D3H rev1.1 motherboard.
+
+Made by following [RehabMan’s guide](https://www.tonymacx86.com/threads/guide-creating-a-custom-ssdt-for-usbinjectall-kext.211311/), saved for future reference and in case anyone else uses this motherboard and is somewhat confused by the guide (as I was, initially).
+
+I have included the `SSDT-UIAC.dsl` file in case you want to make further changes or use this as a template. You can use [MaciASL](https://bitbucket.org/RehabMan/os-x-maciasl-patchmatic) to open and edit the file. Be sure to check **MaciASL » Preferences » iASL » Compiler Options** is set to `ACPI 6.2a` when using the application.
+
+## Note
+This is specifically made for the aforementioned motherboard. It might work with other, similar motherboards, but this is untested on my part. If it does end up working, please post an issue so others can know, too. 
+
+The remainder of this README assumes you’re using Clover Configurator. If you use Xcode or something else to modify your Clover config file, replace Clover Configurator specific references with whatever manual step you need to make to get the same result. 
+
+# Installation
+This assumes you already have a working Clover setup using [USBInjectAll](https://bitbucket.org/RehabMan/os-x-usb-inject-all).
+
+- Mount your EFI partition (e.g. using Clover Configurator)
+- Locate the `EFI/ACPI/patched` folder
+- Copy `SSDT-UIAC.aml` into this folder
+- Open your config file (`EFI/CLOVER/config.plist`) in Clover Configurator
+- In the `Acpi` section, add the `change EHC1 to EH01` and `change EHC2 to EH02` patches (use the `List Of Patches` dropdown menu)
+- Check if `SortedOrder` in the bottom-right hand corner of the SSDT section is empty
+
+### In case SSDT SortedOrder is not empty
+By default your `config.plist` likely has no SSDT `SortedOrder` set, but in case something is listed there, you’ll have to either empty it, or ensure `SSDT-UIAC` is added to the list.
+
+## Reboot
+Reboot and make sure all your USB ports work. You can test this simply by plugging in a USB device in each port and see if it works as expected. [IORegistryExplorer](https://www.tonymacx86.com/index.php?threads/guide-how-make-copy-ioreg.58368/) can be useful for this, too, but it’s not required.
+
+## In case it didn’t work
+You might end up with a computer without any working USB ports. If that happens, reboot and when you get to the Clover boot, hit the spacebar having selected your usual boot option and add the `-uia_ignore_rmcf` boot argument. This will ignore all custom SSDT options, which should help you get to a booted machine with working USB ports, after which you can make whatever changes are necessary to fix the issue.
+
+# Screenshot
+![IORegistryExplorer](hellodeibu.github.com/Gigabyte-GA-B75M-D3H-rev1.1-SSDT-UIAC/Screenshots/IORegistryExplorer.png)
+
--- a/SSDT-UIAC.aml
+++ b/SSDT-UIAC.aml
--- a/SSDT-UIAC.dsl
+++ b/SSDT-UIAC.dsl
@@ -0,0 +1,130 @@
+// SSDT-UIAC-ALL.dsl
+//
+// This SSDT can be used as a template to build your own
+// customization for USBInjectAll.kext.
+//
+// This SSDT contains all ports, so using it is the same as without
+// a custom SSDT.  Delete ports that are not connected or ports you
+// do not need.
+//
+// Change the UsbConnector or portType as needed to match your
+// actual USB configuration.
+//
+// Note:
+// portType=0 seems to indicate normal external USB2 port (as seen in MacBookPro8,1)
+// portType=2 seems to indicate "internal device" (as seen in MacBookPro8,1)
+// portType=4 is used by MacBookPro8,3 (reason/purpose unknown)
+//
+
+DefinitionBlock ("", "SSDT", 2, "hack", "_UIAC", 0)
+{
+    Device(UIAC)
+    {
+        Name(_HID, "UIA00000")
+
+        Name(RMCF, Package()
+        {
+            "HUB1", Package()
+            {
+                "port-count", Buffer() { 8, 0, 0, 0 },
+                "ports", Package()
+                {
+                    "HP15", Package() // USB2 front top
+                    {
+                        //"UsbConnector", 0,
+                        "portType", 0,
+                        "port", Buffer() { 5, 0, 0, 0 },
+                    },
+                    "HP16", Package() // USB2 front bottom
+                    {
+                        //"UsbConnector", 0,
+                        "portType", 0,
+                        "port", Buffer() { 6, 0, 0, 0 },
+                    },                },
+            },
+            "HUB2", Package()
+            {
+                "port-count", Buffer() { 6, 0, 0, 0 },
+                "ports", Package()
+                {
+                    "HP23", Package() // USB2 back right bottom
+                    {
+                        //"UsbConnector", 0,
+                        "portType", 0,
+                        "port", Buffer() { 3, 0, 0, 0 },
+                    },
+                    "HP24", Package() // USB2 back right top
+                    {
+                        //"UsbConnector", 0,
+                        "portType", 0,
+                        "port", Buffer() { 4, 0, 0, 0 },
+                    },
+                    "HP25", Package() // USB2 back left top
+                    {
+                        //"UsbConnector", 0,
+                        "portType", 0,
+                        "port", Buffer() { 5, 0, 0, 0 },
+                    },
+                    "HP26", Package() // USB2 back left bottom
+                    {
+                        //"UsbConnector", 0,
+                        "portType", 0,
+                        "port", Buffer() { 6, 0, 0, 0 },
+                    },
+                },
+            },
+            "EH01", Package()
+            {
+                "port-count", Buffer() { 8, 0, 0, 0 },
+                "ports", Package()
+                {
+                    "PR11", Package() // USB2 front
+                    {
+                        "UsbConnector", 255,
+                        "port", Buffer() { 1, 0, 0, 0 },
+                    },
+                },
+            },
+            "EH02", Package()
+            {
+                "port-count", Buffer() { 6, 0, 0, 0 },
+                "ports", Package()
+                {
+                    "PR21", Package() // USB2 back
+                    {
+                        "UsbConnector", 255,
+                        "port", Buffer() { 1, 0, 0, 0 },
+                    },
+                },
+            },
+            "8086_1e31", Package()
+            {
+                "port-count", Buffer() { 8, 0, 0, 0 },
+                "ports", Package()
+                {
+                    "HS03", Package() // USB3 back bottom
+                    {
+                        "UsbConnector", 3,
+                        "port", Buffer() { 3, 0, 0, 0 },
+                    },
+                    "HS04", Package() // USB3 back top
+                    {
+                        "UsbConnector", 3,
+                        "port", Buffer() { 4, 0, 0, 0 },
+                    },
+                    "SSP7", Package() // USB3 back bottom
+                    {
+                        "UsbConnector", 3,
+                        "port", Buffer() { 7, 0, 0, 0 },
+                    },
+                    "SSP8", Package() // USB3 back top
+                    {
+                        "UsbConnector", 3,
+                        "port", Buffer() { 8, 0, 0, 0 },
+                    },
+                },
+            },
+        })
+    }
+}
+//EOF
--- a/Screenshots/IORegistryExplorer.png
+++ b/Screenshots/IORegistryExplorer.png