| |
| <!doctype html> |
| <html lang="en" class="no-js"> |
| <head> |
| |
| <meta charset="utf-8"> |
| <meta name="viewport" content="width=device-width,initial-scale=1"> |
| |
| |
| |
| <link rel="shortcut icon" href="../../assets/images/favicon.png"> |
| <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.0.1"> |
| |
| |
| |
| <title>Installation Guide (Surface devices) - Team Bliss</title> |
| |
| |
| |
| <link rel="stylesheet" href="../../assets/stylesheets/main.38780c08.min.css"> |
| |
| |
| <link rel="stylesheet" href="../../assets/stylesheets/palette.3f72e892.min.css"> |
| |
| |
| |
| |
| |
| |
| |
| <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin> |
| <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback"> |
| <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style> |
| |
| |
| |
| |
| |
| |
| |
| |
| </head> |
| |
| |
| |
| |
| |
| |
| |
| <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none"> |
| |
| |
| <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off"> |
| <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off"> |
| <label class="md-overlay" for="__drawer"></label> |
| <div data-md-component="skip"> |
| |
| |
| <a href="#installation-guide-surface-devices" class="md-skip"> |
| Skip to content |
| </a> |
| |
| </div> |
| <div data-md-component="announce"> |
| |
| </div> |
| |
| <header class="md-header" data-md-component="header"> |
| <nav class="md-header-nav md-grid" aria-label="Header"> |
| <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo" aria-label="Team Bliss"> |
| |
| |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg> |
| |
| </a> |
| <label class="md-header-nav__button md-icon" for="__drawer"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg> |
| </label> |
| <div class="md-header-nav__title" data-md-component="header-title"> |
| |
| <div class="md-header-nav__ellipsis"> |
| <span class="md-header-nav__topic md-ellipsis"> |
| Team Bliss |
| </span> |
| <span class="md-header-nav__topic md-ellipsis"> |
| |
| Installation Guide (Surface devices) |
| |
| </span> |
| </div> |
| |
| </div> |
| |
| <label class="md-header-nav__button md-icon" for="__search"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> |
| </label> |
| |
| <div class="md-search" data-md-component="search" role="dialog"> |
| <label class="md-search__overlay" for="__search"></label> |
| <div class="md-search__inner" role="search"> |
| <form class="md-search__form" name="search"> |
| <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active"> |
| <label class="md-search__icon md-icon" for="__search"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg> |
| </label> |
| <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg> |
| </button> |
| </form> |
| <div class="md-search__output"> |
| <div class="md-search__scrollwrap" data-md-scrollfix> |
| <div class="md-search-result" data-md-component="search-result"> |
| <div class="md-search-result__meta"> |
| Initializing search |
| </div> |
| <ol class="md-search-result__list"></ol> |
| </div> |
| </div> |
| </div> |
| </div> |
| </div> |
| |
| |
| </nav> |
| </header> |
| |
| <div class="md-container" data-md-component="container"> |
| |
| |
| |
| |
| <main class="md-main" data-md-component="main"> |
| <div class="md-main__inner md-grid"> |
| |
| |
| <div class="md-sidebar md-sidebar--primary" data-md-component="navigation"> |
| <div class="md-sidebar__scrollwrap"> |
| <div class="md-sidebar__inner"> |
| <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0"> |
| <label class="md-nav__title" for="__drawer"> |
| <a href="../.." title="Team Bliss" class="md-nav__button md-logo" aria-label="Team Bliss"> |
| |
| |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg> |
| |
| </a> |
| Team Bliss |
| </label> |
| |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../.." title="Home" class="md-nav__link"> |
| Home |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--active md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked> |
| |
| <label class="md-nav__link" for="nav-2"> |
| Bliss OS |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="Bliss OS" data-md-level="1"> |
| <label class="md-nav__title" for="nav-2"> |
| <span class="md-nav__icon md-icon"></span> |
| Bliss OS |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../build-guide/" title="Build Guide" class="md-nav__link"> |
| Build Guide |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../extras/" title="Extras" class="md-nav__link"> |
| Extras |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link"> |
| Installation Guide (Misc) |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--active"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc"> |
| |
| |
| |
| |
| <a href="./" title="Installation Guide (Surface devices)" class="md-nav__link md-nav__link--active"> |
| Installation Guide (Surface devices) |
| </a> |
| |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../installation-guide/" title="Installation Guide" class="md-nav__link"> |
| Installation Guide |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../taking-bug-reports/" title="Taking bug reports" class="md-nav__link"> |
| Taking bug reports |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link"> |
| Troubleshooting |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3"> |
| |
| <label class="md-nav__link" for="nav-3"> |
| BlissRoms |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="BlissRoms" data-md-level="1"> |
| <label class="md-nav__title" for="nav-3"> |
| <span class="md-nav__icon md-icon"></span> |
| BlissRoms |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../BlissRoms/" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link"> |
| Build Guide |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link"> |
| Build Tips |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4"> |
| |
| <label class="md-nav__link" for="nav-4"> |
| Common |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="Common" data-md-level="1"> |
| <label class="md-nav__title" for="nav-4"> |
| <span class="md-nav__icon md-icon"></span> |
| Common |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/git-started/" title="Git Started" class="md-nav__link"> |
| Git Started |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link"> |
| Maintaining proper authorship |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link"> |
| Using `dippy-bird` |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5"> |
| |
| <label class="md-nav__link" for="nav-5"> |
| Infrastructure |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="Infrastructure" data-md-level="1"> |
| <label class="md-nav__title" for="nav-5"> |
| <span class="md-nav__icon md-icon"></span> |
| Infrastructure |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../infrastructure/" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </div> |
| </div> |
| </div> |
| |
| |
| <div class="md-sidebar md-sidebar--secondary" data-md-component="toc"> |
| <div class="md-sidebar__scrollwrap"> |
| <div class="md-sidebar__inner"> |
| |
| <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> |
| |
| |
| |
| |
| |
| </nav> |
| </div> |
| </div> |
| </div> |
| |
| |
| <div class="md-content"> |
| <article class="md-content__inner md-typeset"> |
| |
| |
| |
| <h1 id="installation-guide-surface-devices">Installation Guide (Surface devices)</h1> |
| <p>This guide is applicable only to Surface devices.</p> |
| <p>Reference posts <a href="https://forum.xda-developers.com/showpost.php?p=78015375&postcount=76">here</a> and <a href="https://forum.xda-developers.com/showpost.php?p=76896155&postcount=2107">here</a>.</p> |
| <p>Do you have a Surface device that you would like to run Bliss OS on? You're in luck, because Bliss OS was primarily developed and tested on a Surface Pro 3 back on Android Nougat.</p> |
| <p>Most Surface devices with IPTS require a specific set of firmware for proper functioning. For all other Surface models, the user must upgrade their own firmware, because we can't build for all Surface models without having those devices to test with.</p> |
| <p>To start, here is the series classification for Surface devices:</p> |
| <ul> |
| <li>Series 5 devices:</li> |
| <li>Surface Book 2</li> |
| <li>Surface Pro 2017</li> |
| <li>Series 4 devices</li> |
| <li>Surface Book</li> |
| <li>Surface Pro 4</li> |
| <li>Surface Laptop</li> |
| <li>Series 3 devices:</li> |
| <li>Surface Pro 3</li> |
| </ul> |
| <p>For the ipts_firmware files (series 4/5 devices only), please select the correct version for your device:</p> |
| <ul> |
| <li><code>v76</code> for the Surface Book</li> |
| <li><code>v78</code> for the Surface Pro 4</li> |
| <li><code>v79</code> for the Surface Laptop</li> |
| <li><code>v101</code> for Surface Book 2 15"</li> |
| <li><code>v102</code> for the Surface Pro 2017</li> |
| <li><code>v137</code> for the Surface Book 2 13"</li> |
| </ul> |
| <p>For the i915_firmware files (series 3/4/5 devices), please select the correct version for your device:</p> |
| <ul> |
| <li><code>kbl</code> for series 5 devices</li> |
| <li><code>skl</code> for series 4 devices</li> |
| <li><code>bxt</code> for series 3 devices</li> |
| </ul> |
| <p>All <a href="https://github.com/jakeday/linux-surface/tree/master/firmware">firmware files can be found here.</a></p> |
| <p>For Surface Go users, you will have to remove some files and replace them with @jakeday's firmware. Please <a href="https://www.reddit.com/r/SurfaceLinux/comments/9t53gq/wifi_fixed_on_surface_go_ubuntu_1810/">see this thread on Reddit</a> for detailed information.</p> |
| <p>Once you have the right firmware you need, you should copy it to a folder on your Bliss install (<code>SD_card_root/surface</code>), making sure to put the right firmware in the right folders:</p> |
| <ul> |
| <li>IPTS firmware: <code>SD_card_root/surface/intel/ipts</code></li> |
| <li><code>ath10k</code> firmware (some models): <code>SD_card_root/surface/ath10k</code></li> |
| <li><code>mrvl</code> firmware (some models): <code>SD_card_root/surface/mrvl</code></li> |
| <li><code>mwlwifi</code> firmware (some models): <code>SD_card_root/surface/mwlwifi</code></li> |
| <li><code>nvidia</code> firmware for Surface Book 2: <code>SD_card_root/surface/nvidia</code></li> |
| </ul> |
| <p>Next, open a terminal (we include one you can enable in "Developer Options"). In the terminal, enter the following commands, giving permission to the superuser popup dialog when prompted:</p> |
| <pre><code>su |
| mv -f SD_card_root/surface/* system/lib/firmware/ |
| </code></pre> |
| <p>Then you can restart:</p> |
| <pre><code>reboot |
| </code></pre> |
| <p>It should recognize and load the correct firmware versions for your device upon reboot if you did everything correctly.</p> |
| |
| |
| |
| |
| |
| |
| |
| </article> |
| </div> |
| </div> |
| </main> |
| |
| |
| <footer class="md-footer"> |
| |
| <div class="md-footer-nav"> |
| <nav class="md-footer-nav__inner md-grid" aria-label="Footer"> |
| |
| <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev"> |
| <div class="md-footer-nav__button md-icon"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg> |
| </div> |
| <div class="md-footer-nav__title"> |
| <div class="md-ellipsis"> |
| <span class="md-footer-nav__direction"> |
| Previous |
| </span> |
| Installation Guide (Misc) |
| </div> |
| </div> |
| </a> |
| |
| |
| <a href="../installation-guide/" title="Installation Guide" class="md-footer-nav__link md-footer-nav__link--next" rel="next"> |
| <div class="md-footer-nav__title"> |
| <div class="md-ellipsis"> |
| <span class="md-footer-nav__direction"> |
| Next |
| </span> |
| Installation Guide |
| </div> |
| </div> |
| <div class="md-footer-nav__button md-icon"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg> |
| </div> |
| </a> |
| |
| </nav> |
| </div> |
| |
| <div class="md-footer-meta md-typeset"> |
| <div class="md-footer-meta__inner md-grid"> |
| <div class="md-footer-copyright"> |
| |
| Made with |
| <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> |
| Material for MkDocs |
| </a> |
| </div> |
| |
| </div> |
| </div> |
| </footer> |
| |
| </div> |
| |
| <script src="../../assets/javascripts/vendor.77e55a48.min.js"></script> |
| <script src="../../assets/javascripts/bundle.aa3f9871.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script> |
| |
| <script> |
| app = initialize({ |
| base: "../..", |
| features: [], |
| search: Object.assign({ |
| worker: "../../assets/javascripts/worker/search.4ac00218.min.js" |
| }, typeof search !== "undefined" && search) |
| }) |
| </script> |
| |
| |
| </body> |
| </html> |