Files
Getting-Started-With-ACPI/Universal/awac.html

598 lines
19 KiB
HTML

<!DOCTYPE HTML>
<html lang="" >
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<title>AWAC vs RTC · 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-anchors/plugin.css">
<link rel="stylesheet" href="../gitbook/gitbook-plugin-medium-zoom/plugin.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="nvram.html" />
<link rel="prev" href="plug.html" />
<style>
@media only screen and (max-width: 640px) {
.book-header .hidden-mobile {
display: none;
}
}
</style>
<script>
window["gitbook-plugin-github-buttons"] = {"buttons":[{"user":"dortania","repo":"Getting-Started-With-ACPI","type":"star","size":"large"}]};
</script>
</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 " 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-disable.html">
<a href="../Desktops/desktop-disable.html">
Disabling desktop dGPUs
</a>
</li>
<li class="header">Laptop</li>
<li class="chapter " data-level="4.1" data-path="../Laptops/backlight.html">
<a href="../Laptops/backlight.html">
Backlight PNLF
</a>
</li>
<li class="chapter " data-level="4.2" data-path="../Laptops/trackpad.html">
<a href="../Laptops/trackpad.html">
Trackpad GPI0
</a>
</li>
<li class="chapter " data-level="4.3" data-path="../Laptops/laptop-disable.html">
<a href="../Laptops/laptop-disable.html">
Disabling laptop dGPUs
</a>
</li>
<li class="header">Universal</li>
<li class="chapter " data-level="5.1" data-path="ec-fix.html">
<a href="ec-fix.html">
Embedded Controller
</a>
</li>
<li class="chapter " data-level="5.2" data-path="plug.html">
<a href="plug.html">
Plugin type
</a>
</li>
<li class="chapter active" data-level="5.3" data-path="awac.html">
<a href="awac.html">
AWAC vs RTC
</a>
</li>
<li class="chapter " data-level="5.4" data-path="nvram.html">
<a href="nvram.html">
NVRAM PMC
</a>
</li>
<li class="chapter " data-level="5.5" data-path="irq.html">
<a href="irq.html">
IRQ Fix
</a>
</li>
<li class="chapter " data-level="5.6" data-path="spoof.html">
<a href="spoof.html">
GPU Spoof
</a>
</li>
<li class="chapter " data-level="5.7" data-path="smbus.html">
<a href="smbus.html">
Fixing SMBus Support
</a>
</li>
<li class="header">Cleanup</li>
<li class="chapter " data-level="6.1" data-path="../cleanup.html">
<a href="../cleanup.html">
Cleanup
</a>
</li>
<li class="header">Misc</li>
<li class="chapter " data-level="7.1" data-path="../troubleshooting.html">
<a href="../troubleshooting.html">
Troubleshooting
</a>
</li>
<li class="chapter " data-level="7.2" data-path="../CONTRIBUTING.html">
<a href="../CONTRIBUTING.html">
Contributing
</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=".." >AWAC vs RTC</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">
<blockquote>
<p><em>Last modified: Mon May 04 2020 23:16:15 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>
<ul>
<li>X299X (10th Gen refresh)</li>
<li>B360</li>
<li>B365</li>
<li>H310</li>
<li>H370</li>
<li>Z370 (Gigabyte and AsRock boards with newer BIOS versions)</li>
<li>Z390</li>
<li>400 series (Cometlake)</li>
<li>495 series (Icelake)</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>
<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>
</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/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>
</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="plug.html" class="navigation navigation-prev " aria-label="Previous page: Plugin type">
<i class="fa fa-angle-left"></i>
</a>
<a href="nvram.html" class="navigation navigation-next " aria-label="Next page: NVRAM PMC">
<i class="fa fa-angle-right"></i>
</a>
</div>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
gitbook.page.hasChanged({"page":{"title":"AWAC vs RTC","level":"5.3","depth":1,"next":{"title":"NVRAM PMC","level":"5.4","depth":1,"path":"Universal/nvram.md","ref":"Universal/nvram.md","articles":[]},"previous":{"title":"Plugin type","level":"5.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-04T23:16:15.336Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-05-04T23:17:12.972Z"},"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-github-buttons/plugin.js"></script>
<script src="../gitbook/gitbook-plugin-medium-zoom/medium-zoom.min.js"></script>
<script src="../gitbook/gitbook-plugin-medium-zoom/plugin.js"></script>
<script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
<script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
</body>
</html>