AskDavis/Getting-Started-With-ACPI
1
0
Fork 0
mirror of https://github.com/AskDavis/Getting-Started-With-ACPI.git synced 2026-01-02 11:59: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 05:56:44 +00:00
parent 44856a53ac
commit ab9efb24a8
68 changed files with 18589 additions and 742 deletions
Download Patch File Download Diff File Expand all files Collapse all files

309
Universal/awac.html
View File

@@ -71,10 +71,10 @@
<link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">
<link rel="next" href="nvram.html" />
<link rel="next" href="awac-methods/prebuilt.html" />
<link rel="prev" href="plug.html" />
<link rel="prev" href="plug-methods/manual.html" />
<style>
@@ -276,6 +276,38 @@
<ul class="articles">
<li class="chapter " data-level="5.1.1" data-path="../Laptops/backlight-methods/prebuilt.html">
<a href="../Laptops/backlight-methods/prebuilt.html">
Prebuilt
</a>
</li>
<li class="chapter " data-level="5.1.2" data-path="../Laptops/backlight-methods/manual.html">
<a href="../Laptops/backlight-methods/manual.html">
Manual
</a>
</li>
</ul>
</li>
<li class="chapter " data-level="5.2" data-path="../Laptops/trackpad.html">
@@ -289,6 +321,38 @@
<ul class="articles">
<li class="chapter " data-level="5.2.1" data-path="../Laptops/trackpad-methods/prebuilt.html">
<a href="../Laptops/trackpad-methods/prebuilt.html">
Prebuilt
</a>
</li>
<li class="chapter " data-level="5.2.2" data-path="../Laptops/trackpad-methods/manual.html">
<a href="../Laptops/trackpad-methods/manual.html">
Manual
</a>
</li>
</ul>
</li>
<li class="chapter " data-level="5.3" data-path="../Laptops/laptop-disable.html">
@@ -322,6 +386,51 @@
<ul class="articles">
<li class="chapter " data-level="6.1.1" data-path="ec-methods/prebuilt.html">
<a href="ec-methods/prebuilt.html">
Prebuilt
</a>
</li>
<li class="chapter " data-level="6.1.2" data-path="ec-methods/ssdttime.html">
<a href="ec-methods/ssdttime.html">
SSDTTime
</a>
</li>
<li class="chapter " data-level="6.1.3" data-path="ec-methods/manual.html">
<a href="ec-methods/manual.html">
Manual
</a>
</li>
</ul>
</li>
<li class="chapter " data-level="6.2" data-path="plug.html">
@@ -335,6 +444,51 @@
<ul class="articles">
<li class="chapter " data-level="6.2.1" data-path="plug-methods/prebuilt.html">
<a href="plug-methods/prebuilt.html">
Prebuilt
</a>
</li>
<li class="chapter " data-level="6.2.2" data-path="plug-methods/ssdttime.html">
<a href="plug-methods/ssdttime.html">
SSDTTime
</a>
</li>
<li class="chapter " data-level="6.2.3" data-path="plug-methods/manual.html">
<a href="plug-methods/manual.html">
Manual
</a>
</li>
</ul>
</li>
<li class="chapter active" data-level="6.3" data-path="awac.html">
@@ -348,6 +502,38 @@
<ul class="articles">
<li class="chapter " data-level="6.3.1" data-path="awac-methods/prebuilt.html">
<a href="awac-methods/prebuilt.html">
Prebuilt
</a>
</li>
<li class="chapter " data-level="6.3.2" data-path="awac-methods/manual.html">
<a href="awac-methods/manual.html">
Manual
</a>
</li>
</ul>
</li>
<li class="chapter " data-level="6.4" data-path="nvram.html">
@@ -361,6 +547,38 @@
<ul class="articles">
<li class="chapter " data-level="6.4.1" data-path="nvram-methods/prebuilt.html">
<a href="nvram-methods/prebuilt.html">
Prebuilt
</a>
</li>
<li class="chapter " data-level="6.4.2" data-path="nvram-methods/manual.html">
<a href="nvram-methods/manual.html">
Manual
</a>
</li>
</ul>
</li>
<li class="chapter " data-level="6.5" data-path="irq.html">
@@ -400,6 +618,25 @@
<ul class="articles">
<li class="chapter " data-level="6.7.1" data-path="smbus-methods/manual.html">
<a href="smbus-methods/manual.html">
Manual
</a>
</li>
</ul>
</li>
@@ -501,12 +738,16 @@
<section class="normal markdown-section">
<blockquote>
<p><em>Last modified: Fri May 29 2020 01:27:44 GMT+0000 (Coordinated Universal Time)</em></p>
<p><em>Last modified: Sun May 31 2020 05:55:38 GMT+0000 (Coordinated Universal Time)</em></p>
</blockquote>
<h1 id="fixing-system-clocks"><a name="fixing-system-clocks" class="plugin-anchor" href="#fixing-system-clocks"><i class="fa fa-link" aria-hidden="true"></i></a>Fixing System Clocks</h1>
<p><strong>For Intel 300 series chipsets and newer</strong>, this also includes X299 refreshes and Icelake laptops. Common machines:</p>
<h1 id="fixing-system-clocks-ssdt-awacrtc0"><a name="fixing-system-clocks-ssdt-awacrtc0" class="plugin-anchor" href="#fixing-system-clocks-ssdt-awacrtc0"><i class="fa fa-link" aria-hidden="true"></i></a>Fixing System Clocks (SSDT-AWAC/RTC0)</h1>
<ul>
<li><a href="#what-this-ssdt-does">What this SSDT does</a></li>
<li><a href="#methods-to-make-this-ssdt">Methods to make this SSDT</a></li>
</ul>
<h2 id="what-this-ssdt-does"><a name="what-this-ssdt-does" class="plugin-anchor" href="#what-this-ssdt-does"><i class="fa fa-link" aria-hidden="true"></i></a>What this SSDT does</h2>
<p>The purpose of SSDT-AWAC/RTC0 is to fix the system clocks found on newer hardware, maily found in the following:</p>
<ul>
<li>X299X (10th Gen refresh, AsRock and Asus don&apos;t use the -x naming so you&apos;ll need to double check)</li>
<li>B360</li>
<li>B365</li>
<li>H310</li>
@@ -515,53 +756,17 @@
<li>Z390</li>
<li>B460</li>
<li>Z490</li>
<li>400 series (Cometlake)</li>
<li>400 series (Comet Lake, including Z490)</li>
<li>495 series (Icelake)</li>
<li>X299X (10th Gen refresh, AsRock and Asus don&apos;t use the -x naming so you&apos;ll need to double check)</li>
</ul>
<p>So on newer Intel 300 series motherboards, manufactures started pushing for a new type of system clock: <strong>AWAC</strong>( <strong>A</strong> <strong>W</strong>eird <strong>A</strong>ss <strong>C</strong>lock). One small problem, macOS doesn&apos;t know what the hell an AWAC clock is instead only familiar with the legacy <strong>RTC</strong>(<strong>R</strong>eal <strong>T</strong>ime <strong>C</strong>lock). So we need to figure out how to bring back the old clock, thats where <code>SSDT-AWAC</code> and <code>SSDT-RTC0</code> come in:</p>
<p>SSDT-AWAC tries to re-enable the old RTC clock that is compatible with macOS, while SSDT-RTC0 will instead create a &quot;fake&quot; RTC clock if there is no legacy one to enable.</p>
<h2 id="methods-to-make-this-ssdt"><a name="methods-to-make-this-ssdt" class="plugin-anchor" href="#methods-to-make-this-ssdt"><i class="fa fa-link" aria-hidden="true"></i></a>Methods to make this SSDT</h2>
<p>For the RTC fix, there are 2 methods you can choose from:</p>
<ul>
<li><p><a href="https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl" target="_blank">SSDT-AWAC</a></p>
<ul>
<li>Disables AWAC and enables RTC</li>
<li>In your DSDT, there&apos;s a variable called <code>STAS</code> used for holding either a <code>One</code> or <code>Zero</code> to determine which clock to use(<code>One</code> for RTC and <code>Zero</code> for AWAC)</li>
<li><a href="awac-methods/prebuilt.html">Prebuilt</a></li>
<li><a href="awac-methods/manual.html">Manual</a></li>
</ul>
</li>
<li><p><a href="https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-RTC0.dsl" target="_blank">SSDT-RTC0</a></p>
<ul>
<li>Used for creating a fake RTC device for macOS to play with</li>
<li>In very rare circumstances, some DSDTs may not have a legacy RTC to fall back on. When this happens, we&apos;ll want to create a fake device to make macOS happy</li>
</ul>
</li>
</ul>
<p>Note: AWAC actually stands for ACPI Wake Alarm Counter/Clock for those curious, though I&apos;ll forever know it as A Weird Ass Clock ;p</p>
<h2 id="determining-which-ssdt-you-need"><a name="determining-which-ssdt-you-need" class="plugin-anchor" href="#determining-which-ssdt-you-need"><i class="fa fa-link" aria-hidden="true"></i></a>Determining which SSDT you need</h2>
<p>To determine whether you need <a href="https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl" target="_blank">SSDT-AWAC</a> or <a href="https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-RTC0.dsl" target="_blank">SSDT-RTC0</a>:</p>
<ul>
<li>open your decompiled DSDT and search for <code>Device (AWAC)</code></li>
<li>If <strong>nothing shows up</strong> then no need to continue and <strong>no need for this SSDT</strong> as you have no AWAC. <strong>Otherwise, continue on!</strong></li>
<li>If you get a result then you have an <code>AWAC</code> system clock present, then continue with the <strong>next search for <code>STAS</code></strong>:</li>
</ul>
<p><img src="../images/Universal/awac-md/stas.png" alt=""></p>
<p>As you can see we found the <code>STAS</code> in our DSDT, this means we&apos;re able to force enable our Legacy RTC. In this case, <a href="https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl" target="_blank">SSDT-AWAC</a> will be used As-Is with no modifications required. Just need to compile. Note that <code>STAS</code> may be found in AWAC first instead of RTC like in our example, this is normal.</p>
<p>For systems where <strong>no <code>STAS</code></strong> shows up <strong>but</strong> you do have <code>AWAC</code>, you can use <a href="https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-RTC0.dsl" target="_blank">SSDT-RTC0</a> though you will need to check the naming of LPC in your DSDT</p>
<p>By default the SSDT uses <code>LPCB</code>, you can check what your system uses by just searching for <code>Name (_ADR, 0x001F0000)</code>. This address is used for Low Pin Count devices(LPC) but the device name can vary between <code>LPCB</code>, <code>LBC</code> or <code>LBC0</code>:</p>
<p><img src="../images/Universal/awac-md/lpc.png" alt=""></p>
<h2 id="ini-edge-cases"><a name="ini-edge-cases" class="plugin-anchor" href="#ini-edge-cases"><i class="fa fa-link" aria-hidden="true"></i></a>_INI Edge Cases</h2>
<p>Mainly seen on X299 refresh boards, there&apos;s already a <code>Scope (_SB) { Method (_INI...</code> in your DSDT. This means our SSDT-AWAC will conflict with the one found in our DSDT. For these situations, you&apos;ll want to remove <code>Method (_INI, 0, NotSerialized) {}</code> from the SSDT. You&apos;ll be left this this in the end:</p>
<pre><code>DefinitionBlock (&quot;&quot;, &quot;SSDT&quot;, 2, &quot;DRTNIA&quot;, &quot;AWAC&quot;, 0x00000000)
{
External (STAS, IntObj)
Scope (_SB)
{
If (_OSI (&quot;Darwin&quot;))
{
STAS = One
}
}
}
</code></pre><p>You can find a prebuilt of this here: <a href="https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-AWAC.aml" target="_blank">SSDT-AWAC.aml</a></p>
<h2 id="now-youre-ready-to-compile-the-ssdt"><a name="now-youre-ready-to-compile-the-ssdt" class="plugin-anchor" href="#now-youre-ready-to-compile-the-ssdt"><i class="fa fa-link" aria-hidden="true"></i></a><a href="../Manual/compile.html">Now you&apos;re ready to compile the SSDT!</a></h2>
</section>
@@ -589,12 +794,12 @@
<a href="plug.html" class="navigation navigation-prev " aria-label="Previous page: Plugin type">
<a href="plug-methods/manual.html" class="navigation navigation-prev " aria-label="Previous page: Manual">
<i class="fa fa-angle-left"></i>
</a>
<a href="nvram.html" class="navigation navigation-next " aria-label="Next page: NVRAM PMC">
<a href="awac-methods/prebuilt.html" class="navigation navigation-next " aria-label="Next page: Prebuilt">
<i class="fa fa-angle-right"></i>
</a>
@@ -605,7 +810,7 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
gitbook.page.hasChanged({"page":{"title":"AWAC vs RTC","level":"6.3","depth":1,"next":{"title":"NVRAM PMC","level":"6.4","depth":1,"path":"Universal/nvram.md","ref":"Universal/nvram.md","articles":[]},"previous":{"title":"Plugin type","level":"6.2","depth":1,"path":"Universal/plug.md","ref":"Universal/plug.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":"Universal/awac.md","mtime":"2020-05-29T01:27:44.868Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-05-29T01:28:38.922Z"},"basePath":"..","book":{"language":""}});
gitbook.page.hasChanged({"page":{"title":"AWAC vs RTC","level":"6.3","depth":1,"next":{"title":"Prebuilt","level":"6.3.1","depth":2,"path":"Universal/awac-methods/prebuilt.md","ref":"Universal/awac-methods/prebuilt.md","articles":[]},"previous":{"title":"Manual","level":"6.2.3","depth":2,"path":"Universal/plug-methods/manual.md","ref":"Universal/plug-methods/manual.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":"Universal/awac.md","mtime":"2020-05-31T05:55:38.188Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-05-31T05:56:32.982Z"},"basePath":"..","book":{"language":""}});
});
</script>
</div>