mirror of
https://github.com/AskDavis/Getting-Started-With-ACPI.git
synced 2026-01-02 11:59:48 -08:00
485 lines
15 KiB
HTML
485 lines
15 KiB
HTML
|
|
<!DOCTYPE HTML>
|
|
<html lang="" >
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
|
<title>SSDTs: Easy Way · GitBook</title>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
|
<meta name="description" content="">
|
|
<meta name="generator" content="GitBook 3.2.3">
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="gitbook/style.css">
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="gitbook/gitbook-plugin-search-plus/search.css">
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="styles/website.css">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<meta name="HandheldFriendly" content="true"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
|
|
<meta name="apple-mobile-web-app-capable" content="yes">
|
|
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
|
<link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
|
|
<link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
|
|
|
|
|
|
<link rel="next" href="ssdt-long.html" />
|
|
|
|
|
|
<link rel="prev" href="./" />
|
|
|
|
|
|
</head>
|
|
<body>
|
|
|
|
<div class="book">
|
|
<div class="book-summary">
|
|
|
|
|
|
<div id="book-search-input" role="search">
|
|
<input type="text" placeholder="Type to search" />
|
|
</div>
|
|
|
|
|
|
<nav role="navigation">
|
|
|
|
|
|
|
|
<ul class="summary">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="chapter " data-level="1.1" data-path="./">
|
|
|
|
<a href="./">
|
|
|
|
|
|
Getting Started With ACPI
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter active" data-level="1.2" data-path="ssdt-easy.html">
|
|
|
|
<a href="ssdt-easy.html">
|
|
|
|
|
|
SSDTs: Easy Way
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="1.3" data-path="ssdt-long.html">
|
|
|
|
<a href="ssdt-long.html">
|
|
|
|
|
|
SSDTs: Long Way
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="header">Manual</li>
|
|
|
|
|
|
|
|
<li class="chapter " data-level="2.1" data-path="Manual/dump.html">
|
|
|
|
<a href="Manual/dump.html">
|
|
|
|
|
|
Dumping the DSDT
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="2.2" data-path="Manual/compile.html">
|
|
|
|
<a href="Manual/compile.html">
|
|
|
|
|
|
Decompiling and Compiling
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="header">Desktop</li>
|
|
|
|
|
|
|
|
<li class="chapter " data-level="3.1" data-path="Desktops/desktop-ec.html">
|
|
|
|
<a href="Desktops/desktop-ec.html">
|
|
|
|
|
|
Embedded Controllers
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="header">Laptop</li>
|
|
|
|
|
|
|
|
<li class="chapter " data-level="4.1" data-path="Laptops/laptop-ec.html">
|
|
|
|
<a href="Laptops/laptop-ec.html">
|
|
|
|
|
|
Embedded Controllers
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="4.2" data-path="Laptops/backlight.html">
|
|
|
|
<a href="Laptops/backlight.html">
|
|
|
|
|
|
Backlight PNLF
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="4.3" data-path="Laptops/trackpad.html">
|
|
|
|
<a href="Laptops/trackpad.html">
|
|
|
|
|
|
Trackpad GPIO
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="header">Universal</li>
|
|
|
|
|
|
|
|
<li class="chapter " data-level="5.1" data-path="Universal/plug.html">
|
|
|
|
<a href="Universal/plug.html">
|
|
|
|
|
|
Plugin type
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="5.2" data-path="Universal/awac.html">
|
|
|
|
<a href="Universal/awac.html">
|
|
|
|
|
|
AWAC vs RTC
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="5.3" data-path="Universal/nvram.html">
|
|
|
|
<a href="Universal/nvram.html">
|
|
|
|
|
|
NVRAM PMC
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="5.4" data-path="Universal/xosi.html">
|
|
|
|
<a href="Universal/xosi.html">
|
|
|
|
|
|
XOSI
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
<li class="chapter " data-level="5.5" data-path="Universal/irq.html">
|
|
|
|
<a href="Universal/irq.html">
|
|
|
|
|
|
IRQ Fix
|
|
|
|
</a>
|
|
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="divider"></li>
|
|
|
|
<li>
|
|
<a href="https://www.gitbook.com" target="blank" class="gitbook-link">
|
|
Published with GitBook
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
</nav>
|
|
|
|
|
|
</div>
|
|
|
|
<div class="book-body">
|
|
|
|
<div class="body-inner">
|
|
|
|
|
|
|
|
<div class="book-header" role="navigation">
|
|
|
|
|
|
<!-- Title -->
|
|
<h1>
|
|
<i class="fa fa-circle-o-notch fa-spin"></i>
|
|
<a href="." >SSDTs: Easy Way</a>
|
|
</h1>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<div class="page-wrapper" tabindex="-1" role="main">
|
|
<div class="page-inner">
|
|
|
|
<div class="search-plus" id="book-search-results">
|
|
<div class="search-noresults">
|
|
|
|
<section class="normal markdown-section">
|
|
|
|
<h1 id="ssdts-the-easy-way">SSDTs: The easy way</h1>
|
|
<p>So here we'll be using a super simple tool made by CorpNewt: <a href="https://github.com/corpnewt/SSDTTime" target="_blank">SSDTTime</a></p>
|
|
<p>What this tool does is dumps your DSDT from your firmware, and then creates SSDTs based off your DSDT. <strong>This must be done on the target machine running either Windows or Linux</strong></p>
|
|
<p>So what <strong>can't</strong> SSDTTime do?:</p>
|
|
<ul>
|
|
<li><strong>HEDT SSDTs</strong>: The ACPI is odd on these platforms so manual work is required</li>
|
|
<li><strong>Laptop EC fix</strong>: This is because you need to use an ACPI rename over an SSDT on laptops</li>
|
|
<li><strong>SSDT-PNLF</strong>: No need to configuration required, use prebuilt file <a href="">here</a></li>
|
|
<li><strong>SSDT-GPIO</strong>: No need to configuration required, use prebuilt file <a href="">here</a></li>
|
|
<li><strong>SSDT-XOSI</strong>: No need to configuration required, use prebuilt file <a href="">here</a></li>
|
|
<li><strong>AWAC and RTC0 SSDTs</strong>: 300 series intel boards will also need to figure his out(Z390 systems are most common for requiring this but some gigabyte Z370 do as well)</li>
|
|
<li><strong>PMC SSDT</strong>: For fixing 300 series intel NVRAM, a prebuilt for <code>PCI0.LPCB</code> can be found here: <a href="https://github.com/khronokernel/Opencore-Vanilla-Desktop-Guide/blob/master/extra-files/SSDT-PMC.aml" target="_blank">SSDT-PMC.aml</a></li>
|
|
<li><strong>USBX SSDT</strong>: This is included on sample SSDTs but SSDTTime only makes the SSDT-EC part, Skylake and newer users can grab a prebuilt here: <a href="https://github.com/khronokernel/Opencore-Vanilla-Desktop-Guide/blob/master/extra-files/SSDT-USBX.aml" target="_blank">SSDT-USBX.aml</a></li>
|
|
</ul>
|
|
<p>For users who don't have all the options avaible to them in SSDTTime, you can follow the "SSDTs: The long way" section. You can still use SSDTTime for SSDTs it support for you.</p>
|
|
<h2 id="running-ssdttime">Running SSDTTime</h2>
|
|
<p>Run the <code>SSDTTime.bat</code> file as Admin on the target machine and you should see something like this:</p>
|
|
<p><img src="https://cdn.discordapp.com/attachments/456913818467958789/669260286007705623/unknown.png" alt=""></p>
|
|
<p>What are all these options?:</p>
|
|
<ul>
|
|
<li><code>1. FixHPET - Patch out IRQ Conflicts</code><ul>
|
|
<li>IRQ patching, mainly needed for X79, X99 and laptop users</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>2. FakeEC - OS-aware Fake EC</code><ul>
|
|
<li>This is the SSDT-EC, required for Catalina users</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>3. PluginType - Sets plugin-type = 1 on CPU0/PR00</code><ul>
|
|
<li>This is the SSDT-PLUG, for Intel only</li>
|
|
</ul>
|
|
</li>
|
|
<li><code>4. Dump DSDT - Automatically dump the system DSDT</code><ul>
|
|
<li>Dumps your DSDT from your firmware</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p>What we want to do is select option <code>4. Dump DSDT</code> first, then select the appropriate option(s) for your system. </p>
|
|
<blockquote>
|
|
<p>What about USBX?</p>
|
|
</blockquote>
|
|
<p>For Skylake+ and AMD, you can grab a prebuilt file here: <a href="https://github.com/khronokernel/Opencore-Vanilla-Desktop-Guide/blob/master/extra-files/SSDT-USBX.aml" target="_blank">SSDT-USBX.aml</a>. This file is plug and play and requires no device configuration, <strong>do not use on Haswell and older</strong>.</p>
|
|
<p><strong>Troubleshooting note</strong>: See <a href="troubleshooting/troubleshooting">General Troubleshooting</a>.md if you're having issues running SSDTTime</p>
|
|
<h2 id="adding-to-opencore">Adding to OpenCore</h2>
|
|
<p>Don't forget that SSDTs need to be added to Opencore, eminder that .aml is complied, .dsl is code. <strong>Add only the .aml file</strong>:</p>
|
|
<ul>
|
|
<li>EFI/OC/ACPI</li>
|
|
<li>config.plist -> ACPI -> Add</li>
|
|
</ul>
|
|
<p>Reminder that Cmd/Crtl+R with ProperTree pointed at your OC folder will add all your SSDTs, kexts and .efi drivers to the config for you. Do not add your DSDT to OpenCore, its already in your firmware</p>
|
|
<p>Users of <code>FixHPET</code> will also need to merge c_patches.plist into their config.plist</p>
|
|
<p>Steps to do this:</p>
|
|
<ul>
|
|
<li>Open both files, </li>
|
|
<li>Delete the <code>ACPI -> Patch</code> section from config.plist</li>
|
|
<li>Copy the <code>ACPI -> Patch</code> section from patches.plist</li>
|
|
<li>Paste into where old patches were in config.plist</li>
|
|
</ul>
|
|
|
|
|
|
</section>
|
|
|
|
</div>
|
|
<div class="search-results">
|
|
<div class="has-results">
|
|
|
|
<h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
|
|
<ul class="search-results-list"></ul>
|
|
|
|
</div>
|
|
<div class="no-results">
|
|
|
|
<h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<a href="./" class="navigation navigation-prev " aria-label="Previous page: Getting Started With ACPI">
|
|
<i class="fa fa-angle-left"></i>
|
|
</a>
|
|
|
|
|
|
<a href="ssdt-long.html" class="navigation navigation-next " aria-label="Next page: SSDTs: Long Way">
|
|
<i class="fa fa-angle-right"></i>
|
|
</a>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
<script>
|
|
var gitbook = gitbook || [];
|
|
gitbook.push(function() {
|
|
gitbook.page.hasChanged({"page":{"title":"SSDTs: Easy Way","level":"1.2","depth":1,"next":{"title":"SSDTs: Long Way","level":"1.3","depth":1,"path":"ssdt-long.md","ref":"ssdt-long.md","articles":[]},"previous":{"title":"Getting Started With ACPI","level":"1.1","depth":1,"path":"README.md","ref":"README.md","articles":[]},"dir":"ltr"},"config":{"plugins":["theme-default","-lunr","-search","search-plus","addcssjs","favicon-plus"],"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":{"output":"_book","addcssjs":{"css":[],"js":[]},"fontsettings":{"theme":"night","family":"sans","size":2},"favicon-plus":{"appleTouchIconPrecomposed152":"","favicon":"","output":"_book"},"highlight":{},"favicon":"/icons/favicon.ico","appleTouchIconPrecomposed152":"/icons/appleTouchIconPrecomposed152.png","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"}},"search-plus":{}},"theme":"default","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":"ssdt-easy.md","mtime":"2020-02-04T22:59:18.661Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-02-04T23:00:04.229Z"},"basePath":".","book":{"language":""}});
|
|
});
|
|
</script>
|
|
</div>
|
|
|
|
|
|
|
|
<script src="gitbook/gitbook.js"></script>
|
|
<script src="gitbook/theme.js"></script>
|
|
|
|
|
|
<script src="gitbook/gitbook-plugin-search-plus/jquery.mark.min.js"></script>
|
|
|
|
|
|
|
|
<script src="gitbook/gitbook-plugin-search-plus/search.js"></script>
|
|
|
|
|
|
|
|
<script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
|
|
|
|
|
|
|
|
<script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
|
|
|
|
|
|
|
|
|
|
|
|
</body>
|
|
</html>
|
|
|