Misc Fixes

- Inital lint'ing
- Clean up README.md table
- Add CONTRIBUTING.md
- Add TROUBLESHOOTING.md
This commit is contained in:
Mykola Grymalyuk
2020-04-18 13:29:12 -06:00
parent fb33ef4979
commit 17f7c8aba3
43 changed files with 13509 additions and 164 deletions

View File

@@ -1,6 +1,6 @@
# Compiling and decompiling ACPI Tables
See [General Troubleshooting](https://dortania.github.io/OpenCore-Desktop-Guide/troubleshooting/troubleshooting) if you have dumping/compiling errors
See [Troubleshooting](/troubleshooting.md) if you have dumping/compiling errors
* [macOS Compiling and Decompiling](/Manual/compile.md#macos)
* [Windows Compiling and Decompiling](/Manual/compile.md#windows)
@@ -15,9 +15,10 @@ For those who prefer the command line, grab [iasl-stable](https://github.com/aci
```text
path/to/iasl.exe path/to/DSDT.aml
```
* If compiled .aml file is provided, a decompiled .dsl file will be given and vice versa.
![](https://cdn.discordapp.com/attachments/683011276938543134/695854856681816144/Screen_Shot_2020-04-03_at_10.38.18_PM.png)
![](/images/Manual/compile-md/macos-compile.png)
## Windows
@@ -27,7 +28,7 @@ Compiling and decompiling on windows is fairly simple though, you will need [ias
path/to/iasl.exe path/to/DSDT.aml
```
![](https://i.imgur.com/IY7HMof.png)
![](/images/Manual/compile-md/windows-compile.png)
* If compiled .aml file is provided, a decompiled .dsl file will be given and vice versa.
@@ -39,4 +40,4 @@ Compiling and decompiling with Linux is just as simple, you will need a special
path/to/iasl path/to/DSDT.aml
```
* If compiled .aml file is provided, a decompiled .dsl file will be given and vice versa.
* If compiled .aml file is provided, a decompiled .dsl file will be given and vice versa.

View File

@@ -2,11 +2,9 @@
So to start, we'll need to get a copy of your DSDT from your firmware. The easiest way is grabbing the DSDT.aml SSDTTime dumped for us earlier but here are some other options:
* [SSDTTime](https://github.com/corpnewt/SSDTTime)
* Supports both Windows and Linux for DSDT dumping
* `4. Dump DSDT - Automatically dump the system DSDT`
* Supports both Windows and Linux for DSDT dumping
* `4. Dump DSDT - Automatically dump the system DSDT`
* [MaciASL](https://github.com/acidanthera/MaciASL/releases)
* Open the app on the target machine(must already be running macOS) and the system's DSDT will show, then File -> SaveAs `System DSDT`. Make sure the file format is ACPI Machine Language Binary(.AML), this will require the machine to be running macOS
* Do note that all ACPI patches from clover/OpenCore will be applied to the DSDT
@@ -17,7 +15,7 @@ So to start, we'll need to get a copy of your DSDT from your firmware. The easie
* [`acpidump.efi`](https://github.com/dortania/OpenCore-Desktop-Guide/tree/master/extra-files/acpidump.efi.zip)
* Add this to `EFI/OC/Tools` and in your config under `Misc -> Tools` with the argument: `-b -n DSDT -z` and select this option in OpenCore's picker. Rename the DSDT.dat to DSDT.aml. Tool is provided by [acpica](https://github.com/acpica/acpica/tree/master/source/tools/acpidump)
If OpenCore is having issues running acpidump, you can call it from the shell with [OpenCoreShell](https://github.com/acidanthera/OpenCoreShell/releases)(reminder to add to both `EFI/OC/Tools` and in your config under `Misc -> Tools` ):
If OpenCore is having issues running acpidump, you can call it from the shell with [OpenShell](https://github.com/acidanthera/OpenCorePkg/releases)(reminder to add to both `EFI/OC/Tools` and in your config under `Misc -> Tools` ):
```text
shell> fs0: // replace with proper drive
@@ -32,4 +30,3 @@ fs0:\> cd EFI\OC\Tools
fs0:\EFI\OC\Tools> acpidump.efi -b -n DSDT -z
```