AskDavis/Getting-Started-With-ACPI
1
0
Fork 0
mirror of https://github.com/AskDavis/Getting-Started-With-ACPI.git synced 2026-01-02 20:09:48 -08:00
Code Issues Packages Projects Releases Wiki Activity

Deploy dortania/Getting-Started-With-ACPI to github.com/dortania/Getting-Started-With-ACPI.git:gh-pages

Browse Source
This commit is contained in:
Travis Build Bot (from Travis CI)
2020-05-31 16:37:07 +00:00
parent 7a9e85fd63
commit 9134ca344b
39 changed files with 119 additions and 96 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
Manual/compile.html
View File

@@ -738,7 +738,7 @@
<section class="normal markdown-section">
<blockquote>
<p><em>Last modified: Sun May 31 2020 06:13:18 GMT+0000 (Coordinated Universal Time)</em></p>
<p><em>Last modified: Sun May 31 2020 16:36:04 GMT+0000 (Coordinated Universal Time)</em></p>
</blockquote>
<h1 id="compiling-and-decompiling-acpi-tables"><a name="compiling-and-decompiling-acpi-tables" class="plugin-anchor" href="#compiling-and-decompiling-acpi-tables"><i class="fa fa-link" aria-hidden="true"></i></a>Compiling and decompiling ACPI Tables</h1>
<p>See <a href="../troubleshooting.html">Troubleshooting</a> if you have dumping/compiling errors</p>
@@ -814,7 +814,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
gitbook.page.hasChanged({"page":{"title":"Decompiling and Compiling","level":"3.2","depth":1,"next":{"title":"Disabling desktop dGPUs","level":"4.1","depth":1,"path":"Desktops/desktop-disable.md","ref":"Desktops/desktop-disable.md","articles":[]},"previous":{"title":"Dumping the DSDT","level":"3.1","depth":1,"path":"Manual/dump.md","ref":"Manual/dump.md","articles":[]},"dir":"ltr"},"config":{"plugins":["theme-default","-lunr","-search","search-plus","addcssjs","favicon-plus","anchors","github-buttons","last-modified","medium-zoom"],"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"},"pluginsConfig":{"last-modified":{},"output":"_book","intopic-toc":{"label":"Navigation"},"addcssjs":{"css":[],"js":[]},"medium-zoom":{},"fontsettings":{"theme":"night","family":"sans","size":2},"favicon-plus":{"appleTouchIconPrecomposed152":"","favicon":"","output":"_book"},"highlight":{},"github-edit":{"repo":"dortania/Getting-Started-With-ACPI","branch":"master"},"favicon":"/icons/favicon.ico","appleTouchIconPrecomposed152":"/icons/appleTouchIconPrecomposed152.png","github-buttons":{"buttons":[{"user":"dortania","repo":"Getting-Started-With-ACPI","type":"star","size":"large"}]},"sharing":{"facebook":false,"twitter":false,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":[]},"theme-default":{"showLevel":false,"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"}},"anchors":{},"search-plus":{}},"theme":"default","medium-zoom":{"margin":24,"background":"#363b40","scrollOffset":0},"pdf":{"pageBreaksBefore":"/","headerTemplate":null,"paperSize":"a4","margin":{"right":62,"left":62,"top":36,"bottom":36},"fontSize":12,"fontFamily":"Arial","footerTemplate":null,"chapterMark":"pagebreak","pageNumbers":false},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"links":{"sharing":{"google":false,"facebook":false,"twitter":false,"weibo":false,"all":false}},"gitbook":"*"},"file":{"path":"Manual/compile.md","mtime":"2020-05-31T06:13:18.926Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-05-31T06:14:11.841Z"},"basePath":"..","book":{"language":""}});
gitbook.page.hasChanged({"page":{"title":"Decompiling and Compiling","level":"3.2","depth":1,"next":{"title":"Disabling desktop dGPUs","level":"4.1","depth":1,"path":"Desktops/desktop-disable.md","ref":"Desktops/desktop-disable.md","articles":[]},"previous":{"title":"Dumping the DSDT","level":"3.1","depth":1,"path":"Manual/dump.md","ref":"Manual/dump.md","articles":[]},"dir":"ltr"},"config":{"plugins":["theme-default","-lunr","-search","search-plus","addcssjs","favicon-plus","anchors","github-buttons","last-modified","medium-zoom"],"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"},"pluginsConfig":{"last-modified":{},"output":"_book","intopic-toc":{"label":"Navigation"},"addcssjs":{"css":[],"js":[]},"medium-zoom":{},"fontsettings":{"theme":"night","family":"sans","size":2},"favicon-plus":{"appleTouchIconPrecomposed152":"","favicon":"","output":"_book"},"highlight":{},"github-edit":{"repo":"dortania/Getting-Started-With-ACPI","branch":"master"},"favicon":"/icons/favicon.ico","appleTouchIconPrecomposed152":"/icons/appleTouchIconPrecomposed152.png","github-buttons":{"buttons":[{"user":"dortania","repo":"Getting-Started-With-ACPI","type":"star","size":"large"}]},"sharing":{"facebook":false,"twitter":false,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":[]},"theme-default":{"showLevel":false,"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"}},"anchors":{},"search-plus":{}},"theme":"default","medium-zoom":{"margin":24,"background":"#363b40","scrollOffset":0},"pdf":{"pageBreaksBefore":"/","headerTemplate":null,"paperSize":"a4","margin":{"right":62,"left":62,"top":36,"bottom":36},"fontSize":12,"fontFamily":"Arial","footerTemplate":null,"chapterMark":"pagebreak","pageNumbers":false},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"links":{"sharing":{"google":false,"facebook":false,"twitter":false,"weibo":false,"all":false}},"gitbook":"*"},"file":{"path":"Manual/compile.md","mtime":"2020-05-31T16:36:04.664Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-05-31T16:36:55.003Z"},"basePath":"..","book":{"language":""}});
});
</script>
</div>

69
Manual/dump.html
View File

@@ -738,47 +738,70 @@
<section class="normal markdown-section">
<blockquote>
<p><em>Last modified: Sun May 31 2020 06:13:18 GMT+0000 (Coordinated Universal Time)</em></p>
<p><em>Last modified: Sun May 31 2020 16:36:04 GMT+0000 (Coordinated Universal Time)</em></p>
</blockquote>
<h1 id="getting-a-copy-of-our-dsdt"><a name="getting-a-copy-of-our-dsdt" class="plugin-anchor" href="#getting-a-copy-of-our-dsdt"><i class="fa fa-link" aria-hidden="true"></i></a>Getting a copy of our DSDT</h1>
<p>So to start, we&apos;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:</p>
<p><strong>From Windows</strong>:</p>
<ul>
<li><a href="https://github.com/corpnewt/SSDTTime" target="_blank">SSDTTime</a><ul>
<li>Supports both Windows and Linux for DSDT dumping</li>
<li><code>4. Dump DSDT - Automatically dump the system DSDT</code></li>
</ul>
</li>
<li><a href="https://github.com/acidanthera/MaciASL/releases" target="_blank">MaciASL</a><ul>
<li>Open the app on the target machine(must already be running macOS) and the system&apos;s DSDT will show, then File -&gt; SaveAs <code>System DSDT</code>. Make sure the file format is ACPI Machine Language Binary(.AML), this will require the machine to be running macOS</li>
<li>Do note that all ACPI patches from clover/OpenCore will be applied to the DSDT</li>
</ul>
</li>
<li><a href="https://acpica.org/sites/acpica/files/iasl-win-20180105.zip" target="_blank">acpidump.exe</a><ul>
<li><p><a href="https://acpica.org/sites/acpica/files/iasl-win-20180105.zip" target="_blank">acpidump.exe</a></p>
<ul>
<li>In command prompt run <code>path/to/acpidump.exe -b -n DSDT -z</code>, this will dump your DSDT as a .dat file. Rename this to DSDT.aml</li>
</ul>
</li>
<li><p>Do note that all ACPI patches from clover/OpenCore will be applied to the DSDT with the above 2 methods</p>
</li>
</ul>
<p><strong>From Linux</strong>:</p>
<ul>
<li><a href="https://github.com/corpnewt/SSDTTime" target="_blank">SSDTTime</a><ul>
<li>Supports both Windows and Linux for DSDT dumping</li>
<li><code>4. Dump DSDT - Automatically dump the system DSDT</code></li>
</ul>
</li>
<li>Do note that all ACPI patches from clover/OpenCore will be applied to the DSDT with the above method</li>
</ul>
<p><strong>From Clover</strong>:</p>
<p>For those with Clover installed previously, this is a simple way to get your ACPI tables:</p>
<ul>
<li>F4 in Clover Boot menu<ul>
<li>DSDT can be found in <code>EFI/CLOVER/ACPI/origin</code>, the folder <strong>must</strong> exist before dumping</li>
</ul>
</li>
<li><a href="https://github.com/dortania/OpenCore-Desktop-Guide/tree/master/extra-files/acpidump.efi.zip" target="_blank"><code>acpidump.efi</code></a><ul>
<li>Add this to <code>EFI/OC/Tools</code> and in your config under <code>Misc -&gt; Tools</code> with the argument: <code>-b -n DSDT -z</code> and select this option in OpenCore&apos;s picker. Rename the DSDT.dat to DSDT.aml. Tool is provided by <a href="https://github.com/acpica/acpica/tree/master/source/tools/acpidump" target="_blank">acpica</a></li>
</ul>
<p><strong>From OpenCore</strong>:</p>
<p>With OpenCore 0.5.9, we have a new quirk called SysReport which will actually dump our DSDT automatically when hitting the boot screen. The main issues are:</p>
<ul>
<li>You already need a bootable OpenCore USB to get this dump</li>
<li>This also requires a DEBUG version of 0.5.9</li>
</ul>
<p>For the latter, you just need to replace the following files with <a href="https://github.com/acidanthera/OpenCorePkg/releases" target="_blank">DEBUG version</a>:</p>
<ul>
<li>EFI/BOOT/<ul>
<li><code>BOOTx64.efi</code></li>
</ul>
</li>
<li>EFI/OC/Bootstrap/<ul>
<li><code>Bootstrap.efi</code></li>
</ul>
</li>
<li>EFI/OC/Drivers/<ul>
<li><code>OpenRuntime.efi</code></li>
</ul>
</li>
<li>EFI/OC/<ul>
<li><code>OpenCore.efi</code></li>
</ul>
</li>
</ul>
<p>If OpenCore is having issues running acpidump, you can call it from the shell with <a href="https://github.com/acidanthera/OpenCorePkg/releases" target="_blank">OpenShell</a>(reminder to add to both <code>EFI/OC/Tools</code> and in your config under <code>Misc -&gt; Tools</code> ):</p>
<pre><code class="lang-text">shell&gt; fs0: // replace with proper drive
fs0:\&gt; dir // to verify this is the right directory
Directory of fs0:\
01/01/01 3:30p EFI
fs0:\&gt; cd EFI\OC\Tools
fs0:\EFI\OC\Tools&gt; acpidump.efi -b -n DSDT -z
</code></pre>
<p>For the former, you can actually skip the ACPI section, return to the OpenCore guide(<a href="https://dortania.github.io/OpenCore-Desktop-Guide/" target="_blank">Desktop</a>, <a href="https://dortania.github.io/vanilla-laptop-guide/" target="_blank">Laptop</a>) and finish making the USB. Once booted to the picker, you can shut off the PC and check your USB:</p>
<p><img src="../images/Manual/dump-md/sysreport.png" alt=""></p>
<p>And voila! You have a DSDT! Now you can continue on with making SSDTs</p>
</section>
@@ -822,7 +845,7 @@ fs0:\EFI\OC\Tools&gt; acpidump.efi -b -n DSDT -z
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
gitbook.page.hasChanged({"page":{"title":"Dumping the DSDT","level":"3.1","depth":1,"next":{"title":"Decompiling and Compiling","level":"3.2","depth":1,"path":"Manual/compile.md","ref":"Manual/compile.md","articles":[]},"previous":{"title":"SSDTs: Long Way","level":"2.1.3","depth":2,"path":"ssdt-methods/ssdt-long.md","ref":"ssdt-methods/ssdt-long.md","articles":[]},"dir":"ltr"},"config":{"plugins":["theme-default","-lunr","-search","search-plus","addcssjs","favicon-plus","anchors","github-buttons","last-modified","medium-zoom"],"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"},"pluginsConfig":{"last-modified":{},"output":"_book","intopic-toc":{"label":"Navigation"},"addcssjs":{"css":[],"js":[]},"medium-zoom":{},"fontsettings":{"theme":"night","family":"sans","size":2},"favicon-plus":{"appleTouchIconPrecomposed152":"","favicon":"","output":"_book"},"highlight":{},"github-edit":{"repo":"dortania/Getting-Started-With-ACPI","branch":"master"},"favicon":"/icons/favicon.ico","appleTouchIconPrecomposed152":"/icons/appleTouchIconPrecomposed152.png","github-buttons":{"buttons":[{"user":"dortania","repo":"Getting-Started-With-ACPI","type":"star","size":"large"}]},"sharing":{"facebook":false,"twitter":false,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":[]},"theme-default":{"showLevel":false,"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"}},"anchors":{},"search-plus":{}},"theme":"default","medium-zoom":{"margin":24,"background":"#363b40","scrollOffset":0},"pdf":{"pageBreaksBefore":"/","headerTemplate":null,"paperSize":"a4","margin":{"right":62,"left":62,"top":36,"bottom":36},"fontSize":12,"fontFamily":"Arial","footerTemplate":null,"chapterMark":"pagebreak","pageNumbers":false},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"links":{"sharing":{"google":false,"facebook":false,"twitter":false,"weibo":false,"all":false}},"gitbook":"*"},"file":{"path":"Manual/dump.md","mtime":"2020-05-31T06:13:18.926Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-05-31T06:14:11.841Z"},"basePath":"..","book":{"language":""}});
gitbook.page.hasChanged({"page":{"title":"Dumping the DSDT","level":"3.1","depth":1,"next":{"title":"Decompiling and Compiling","level":"3.2","depth":1,"path":"Manual/compile.md","ref":"Manual/compile.md","articles":[]},"previous":{"title":"SSDTs: Long Way","level":"2.1.3","depth":2,"path":"ssdt-methods/ssdt-long.md","ref":"ssdt-methods/ssdt-long.md","articles":[]},"dir":"ltr"},"config":{"plugins":["theme-default","-lunr","-search","search-plus","addcssjs","favicon-plus","anchors","github-buttons","last-modified","medium-zoom"],"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"},"pluginsConfig":{"last-modified":{},"output":"_book","intopic-toc":{"label":"Navigation"},"addcssjs":{"css":[],"js":[]},"medium-zoom":{},"fontsettings":{"theme":"night","family":"sans","size":2},"favicon-plus":{"appleTouchIconPrecomposed152":"","favicon":"","output":"_book"},"highlight":{},"github-edit":{"repo":"dortania/Getting-Started-With-ACPI","branch":"master"},"favicon":"/icons/favicon.ico","appleTouchIconPrecomposed152":"/icons/appleTouchIconPrecomposed152.png","github-buttons":{"buttons":[{"user":"dortania","repo":"Getting-Started-With-ACPI","type":"star","size":"large"}]},"sharing":{"facebook":false,"twitter":false,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":[]},"theme-default":{"showLevel":false,"styles":{"ebook":"styles/ebook.css","epub":"styles/epub.css","mobi":"styles/mobi.css","pdf":"styles/pdf.css","print":"styles/print.css","website":"styles/website.css"}},"anchors":{},"search-plus":{}},"theme":"default","medium-zoom":{"margin":24,"background":"#363b40","scrollOffset":0},"pdf":{"pageBreaksBefore":"/","headerTemplate":null,"paperSize":"a4","margin":{"right":62,"left":62,"top":36,"bottom":36},"fontSize":12,"fontFamily":"Arial","footerTemplate":null,"chapterMark":"pagebreak","pageNumbers":false},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"links":{"sharing":{"google":false,"facebook":false,"twitter":false,"weibo":false,"all":false}},"gitbook":"*"},"file":{"path":"Manual/dump.md","mtime":"2020-05-31T16:36:04.664Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-05-31T16:36:55.003Z"},"basePath":"..","book":{"language":""}});
});
</script>
</div>