From f529098759656f27b44ee9287ffe40ecf82eb4c2 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:20:38 -0700 Subject: [PATCH 01/30] Update installing-linux.md --- docs/installing-linux.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/docs/installing-linux.md b/docs/installing-linux.md index 4569f1f0..04bcb5f8 100644 --- a/docs/installing-linux.md +++ b/docs/installing-linux.md @@ -17,12 +17,11 @@ Only Linux kernel 6.1 LTS or newer is supported. {: .warning } Ubuntu and Ubuntu-based distributions, such as Mint or ElementaryOS are unsupported. -**Recommended distros as of June 2023 (in no particular order) are:** +**Recommended distros as of August 2023 (in no particular order) are:** * Arch Linux * Fedora * OpenSUSE Tumbleweed -* Pop!_OS * Debian 12 (Bookworm) ---------------- @@ -30,9 +29,9 @@ Ubuntu and Ubuntu-based distributions, such as Mint or ElementaryOS are unsuppor ### Installation: -1. Create a bootable Linux USB. Ubuntu and Ubuntu based distros have outdated packages and thus are not supported. +1. Create a bootable Linux USB. See [here](bootableusb.html) for a guide. 2. Plug the USB Drive into the Chromebook. -3. Turn on the Chromebook, press `ESC` at the POST screen, and select the USB to boot from. +3. Turn on the Chromebook, press `ESC` at the POST screen (when the boot logo appears), and select your USB to boot from. 4. Install as you would on any other computer. @@ -44,9 +43,17 @@ Ubuntu and Ubuntu-based distributions, such as Mint or ElementaryOS are unsuppor {: .warning } Using AVS on a device with max98357a will blow your speakers. You have been warned. -
+**Prerequisites** +- Python 3.10 or newner +- Git -1. Run WeirdTreeThing's [audio script.](https://github.com/WeirdTreeThing/chromebook-linux-audio) +**Installation** +0. Open a terminal. +1. `git clone https://github.com/WeirdTreeThing/chromebook-linux-audio` +2. `cd chromebook-linux-audio` +3. `./setup-audio` + +For more information please see [WeirdTreeThing's repo](https://github.com/WeirdTreeThing/chromebook-linux-audio) {: .fs-5 } From cbbd7674c1ad931d52491d08d659c197c970f4ff Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:35:58 -0700 Subject: [PATCH 02/30] Create bootableusb.md --- docs/bootableusb.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 docs/bootableusb.md diff --git a/docs/bootableusb.md b/docs/bootableusb.md new file mode 100644 index 00000000..3ae7a87d --- /dev/null +++ b/docs/bootableusb.md @@ -0,0 +1,37 @@ +--- +title: Making a Bootable USB +layout: default +nav_order: 25 +--- + +## Making a Bootable USB + +### Prerequisites +1. Another PC or laptop with at least 8GB storage +2. A internet connection +3. A USB drive or SD card thats at least 8 gigabytes. + - You will be erasing this drive, backup anything if you need to do so. + + +### Downloading a ISO +1. Determine what OS you want. + - For Linux, keep in mind Ubuntu and any derivatives will not work. + - For windows, keep in mind only Windows 10 and newer are supported. +2. Place the ISO in a safe place. + + +### Flashing using Rufus + +For this guide, we will be using Rufus to create our bootable USBs. + +1. Download Rufus from [here](https://rufus.ie/en/). The standard Windows x64 version will do. + + ![image](https://github.com/meghan06/docs/assets/77316348/9d9be52c-8e32-4b2f-ae17-8b3917f64032) + +2. Plug in your USB. +3. Locate and launch Rufus. It should ask you to launch with administrator privileges, select YES. +4. On the right hand side, there should be a button with the words `SELECT` on it. +5. A File Explorer window should pop up, find your ISO of choie, then click `Open`. +6. Click `Start`. The default options should work just fine. +7. Wait for the green bar to say `READY`, then click `Close` and eject your newly made USB +8. Profit From e452395264da584c5c232ecb69374e3ad40f3077 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:38:34 -0700 Subject: [PATCH 03/30] Update bootableusb.md --- docs/bootableusb.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/bootableusb.md b/docs/bootableusb.md index 3ae7a87d..3f708b5c 100644 --- a/docs/bootableusb.md +++ b/docs/bootableusb.md @@ -10,7 +10,7 @@ nav_order: 25 1. Another PC or laptop with at least 8GB storage 2. A internet connection 3. A USB drive or SD card thats at least 8 gigabytes. - - You will be erasing this drive, backup anything if you need to do so. + - You will be erasing this drive, backup anything if you need to do so. ### Downloading a ISO From 557d4f8cfe899e2ed8ff60eb5daee95c5f13ecd2 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:45:35 -0700 Subject: [PATCH 04/30] Move gathering logs from getting-started to debugging page --- docs/debugging.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/debugging.md b/docs/debugging.md index 83d45f78..bdd5aeef 100644 --- a/docs/debugging.md +++ b/docs/debugging.md @@ -10,6 +10,15 @@ This page has instructions on using multiple different utilities to debug issues ----------- +### Grabbing Logs + +* If you're experiencing firmware bugs, provide output from `cbmem` console. +* If you're experiencing issues with Linux, provide output from `dmesg`, `dmidecode` and `journalctl` or `/var/log/messages`, respectively +* Ift you're experiencing issues with Windows, provide screenshots from Device Manager, Event Viewer, coredumps etc. +* If you're experiencing issues with macOS, please ask for help in the Chrultrabook Discord, in the #hackintosh channel. + +----------- + ### Firmware To debug firmware, you will need the following tools: From b52d33b7281e06ae98e3de5bdfa4ea2fae160588 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:46:05 -0700 Subject: [PATCH 05/30] Add terminology table and remove gathering logs section --- docs/getting-started.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 49dadbf8..032cbcb1 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -5,7 +5,13 @@ nav_order: 4 --- ## Getting Started -Before we begin, we need to go over a few things. + +### Terminology to know + | **Term** | **Description** | +| - | - | +| chrultrabook | A modified Chromebook/box designed to run Windows, Linux, or even macOS | +| coreboot | UEFI firmware firmware replacement | +| UEFI | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) ------------- @@ -45,14 +51,6 @@ If you are facing a issue, please read the [FAQ](faq.html) first. **Do not use manufacturer's model name or serial number when asking for help** (i.e: HP Chromebook 14a), it doesn't help with identifying the machine. Provide the boardname, otherwise your support request will be ignored. If you don't know where to find your boardname, take a look [here.](system-info.html) -### Provide logs. - -* If you're experiencing firmware bugs, provide output from `cbmem` console. -* If you're experiencing issues with Linux, provide output from `dmesg`, `dmidecode` and `journalctl` or `/var/log/messages`, respectively -* Ift you're experiencing issues with Windows, provide screenshots from Device Manager, Event Viewer, coredumps etc. -* If you're experiencing issues with macOS, please ask for help in the Chrultrabook Discord, in the #hackintosh channel. - -See the [Debugging Page](debugging.html) for instructions on how to get these logs. -------------- From 6f291d9632ef7a9b6d52c3f04e8885d3787091c5 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:47:54 -0700 Subject: [PATCH 06/30] Add terminology table --- docs/allaboutfirmware.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/allaboutfirmware.md b/docs/allaboutfirmware.md index 1f5e7f06..5ea365fd 100644 --- a/docs/allaboutfirmware.md +++ b/docs/allaboutfirmware.md @@ -7,6 +7,14 @@ nav_order: 8 ## All About Firmware +### Terminology +| **Term** | **Description** | +| - | - | +| coreboot | UEFI firmware firmware replacement | +| UEFI | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) +| EC | Embedded Controller. Communicates between the main board and embedded peripherals such as hotkeys, ports, or battery. + + ### Firmware Types ---------------------- From 8e06fac27d4a73966ad29d0f77cb572587fcb498 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:49:28 -0700 Subject: [PATCH 07/30] Add terminology --- docs/firmware.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/firmware.md b/docs/firmware.md index 93af4f6b..f71f454e 100644 --- a/docs/firmware.md +++ b/docs/firmware.md @@ -4,6 +4,14 @@ layout: default nav_order: 9 --- +### Terminology + +| **Term** | **Description** | +| - | - | +| SuzyQable | A cable that enables CCD (Closed Case Debug). Used to disable WP. + + + **Flashing Custom Firmware** Refer to [here](allaboutfirmware.html) for an overview of both RW_LEGACY and UEFI. From 8f79ced0474010543f1af6eefaf5c5c4067a4ad6 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:52:37 -0700 Subject: [PATCH 08/30] Create parent for advanced pages --- docs/advanced.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 docs/advanced.md diff --git a/docs/advanced.md b/docs/advanced.md new file mode 100644 index 00000000..eaef6b2e --- /dev/null +++ b/docs/advanced.md @@ -0,0 +1,12 @@ +--- +title: Advanced +layout: default +nav_order: 17 +has_children: true +--- + +## Advanced + +These pages are for advanced users only. If you are just a average user, you probably don't need to read this. + +It never hurts to do, though 😉. From 601b3fd2a6da7aa25b7d04b17beb85a1d00d1ccc Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:54:27 -0700 Subject: [PATCH 09/30] Update unbricking.md --- docs/unbricking.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/unbricking.md b/docs/unbricking.md index 8bb464e3..8a64712c 100644 --- a/docs/unbricking.md +++ b/docs/unbricking.md @@ -2,6 +2,7 @@ title: Unbricking layout: default nav_order: 19 +parent: Advanced --- ## Unbricking From cb9fdacd55263f157df4738d425bd14cb36478fd Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:54:49 -0700 Subject: [PATCH 10/30] Set Unbricking page to be a child of "Advanced" --- docs/unbricking.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/unbricking.md b/docs/unbricking.md index 8a64712c..1c62a38e 100644 --- a/docs/unbricking.md +++ b/docs/unbricking.md @@ -2,7 +2,7 @@ title: Unbricking layout: default nav_order: 19 -parent: Advanced +parent: Advanced --- ## Unbricking From 0aedf4f1a57223a5dd1dbd39f54dd8912ca2b801 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:55:18 -0700 Subject: [PATCH 11/30] Set Distro Config page to be a child of "Advanced" --- docs/distros.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/distros.md b/docs/distros.md index e4ceeef6..e3cf68ba 100644 --- a/docs/distros.md +++ b/docs/distros.md @@ -2,6 +2,7 @@ title: Distro Specific Configuration layout: default nav_order: 23 +parent: Advanced --- From 0e87fc76bb3c1c77ccee6bc368ce39fc53b97413 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:55:28 -0700 Subject: [PATCH 12/30] Set Compiling Coreboot page to be a child of "Advanced" --- docs/compiling-coreboot.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/compiling-coreboot.md b/docs/compiling-coreboot.md index 77ec176e..8c647b00 100644 --- a/docs/compiling-coreboot.md +++ b/docs/compiling-coreboot.md @@ -2,6 +2,7 @@ title: Compiling Custom Firmware layout: default nav_order: 18 +parent: Advanced --- ### Cloning & Building ROMs From cce10feb0fcd834786ffc9f2a54212d57cf57152 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:55:36 -0700 Subject: [PATCH 13/30] Set debugging page to be a child of "Advanced" --- docs/debugging.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/debugging.md b/docs/debugging.md index bdd5aeef..ed65a1ba 100644 --- a/docs/debugging.md +++ b/docs/debugging.md @@ -2,6 +2,7 @@ title: Debugging layout: default nav_order: 17 +parent: Advanced --- ## Debugging From cf3b3ae228f873caa97bda6e314ad3924957e720 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 20:55:42 -0700 Subject: [PATCH 14/30] Set flipper unbrick page to be a child of "Advanced" --- docs/unbrick-flipper.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/unbrick-flipper.md b/docs/unbrick-flipper.md index bf4cc3d5..fd104094 100644 --- a/docs/unbrick-flipper.md +++ b/docs/unbrick-flipper.md @@ -2,6 +2,7 @@ title: Unbricking with a Flipper Zero layout: default nav_order: 24 +parent: Advanced --- ## Unbricking with a Flipper Zero From cf97442e76f17b24c0e7ba4c35621b9d87181c08 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 21:13:19 -0700 Subject: [PATCH 15/30] Update getting-started.md --- docs/getting-started.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 032cbcb1..925ab4c2 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -7,11 +7,12 @@ nav_order: 4 ## Getting Started ### Terminology to know - | **Term** | **Description** | + +| **Term** | **Description** | | - | - | | chrultrabook | A modified Chromebook/box designed to run Windows, Linux, or even macOS | | coreboot | UEFI firmware firmware replacement | -| UEFI | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) +| UEFI | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) | ------------- From cc1204e604581ee5d7c84177ed0af6128f489521 Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 21:13:31 -0700 Subject: [PATCH 16/30] Fix terminology table --- docs/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 925ab4c2..5e258911 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -6,7 +6,7 @@ nav_order: 4 ## Getting Started -### Terminology to know +### Terminology | **Term** | **Description** | | - | - | From 7ea52b0011bdd829dc2874210a28e235b64e361d Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 21:13:50 -0700 Subject: [PATCH 17/30] Fix terminology page --- docs/firmware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/firmware.md b/docs/firmware.md index f71f454e..7cae3179 100644 --- a/docs/firmware.md +++ b/docs/firmware.md @@ -8,7 +8,7 @@ nav_order: 9 | **Term** | **Description** | | - | - | -| SuzyQable | A cable that enables CCD (Closed Case Debug). Used to disable WP. +| SuzyQable | A cable that enables CCD (Closed Case Debug). Used to disable WP. | From 6d04f92b24669990f0da8fc68f6cd40c9ebf056e Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 21 Aug 2023 21:14:22 -0700 Subject: [PATCH 18/30] Fix terminology table --- docs/allaboutfirmware.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/allaboutfirmware.md b/docs/allaboutfirmware.md index 5ea365fd..373276d5 100644 --- a/docs/allaboutfirmware.md +++ b/docs/allaboutfirmware.md @@ -8,10 +8,11 @@ nav_order: 8 ## All About Firmware ### Terminology + | **Term** | **Description** | | - | - | | coreboot | UEFI firmware firmware replacement | -| UEFI | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) +| UEFI | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) | | EC | Embedded Controller. Communicates between the main board and embedded peripherals such as hotkeys, ports, or battery. From d011a49187aff361898ad2172ede8ce6faba41af Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:06:57 -0700 Subject: [PATCH 19/30] Remove unnecessary jumper links, supported-devices --- docs/supported-devices.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/supported-devices.md b/docs/supported-devices.md index c77e629e..f75b4090 100644 --- a/docs/supported-devices.md +++ b/docs/supported-devices.md @@ -107,7 +107,7 @@ If your device isn't listed, it doesn't have custom firmware support. - ✅ [1] + ✅ jumper @@ -564,7 +564,7 @@ If your device isn't listed, it doesn't have custom firmware support. EOL - ✅ [2] + ✅ screw @@ -1899,7 +1899,7 @@ If your device isn't listed, it doesn't have custom firmware support. ALEENA - ✅ [3] + ✅ ✅ @@ -1912,7 +1912,7 @@ If your device isn't listed, it doesn't have custom firmware support. BARLA - ✅ [3] + ✅ ✅ @@ -1925,7 +1925,7 @@ If your device isn't listed, it doesn't have custom firmware support. CAREENA - ✅ [3] + ✅ ✅ @@ -1938,7 +1938,7 @@ If your device isn't listed, it doesn't have custom firmware support. KASUMI - ✅ [3] + ✅ ✅ @@ -1951,7 +1951,7 @@ If your device isn't listed, it doesn't have custom firmware support. KASUMI360 - ✅ [3] + ✅ ✅ @@ -1964,7 +1964,7 @@ If your device isn't listed, it doesn't have custom firmware support. LIARA - ✅ [3] + ✅ ✅ @@ -1977,7 +1977,7 @@ If your device isn't listed, it doesn't have custom firmware support. TREEYA - ✅ [3] + ✅ ✅ @@ -1990,7 +1990,7 @@ If your device isn't listed, it doesn't have custom firmware support. TREEYA360 - ✅ [3] + ✅ ✅ From 3d10fd4b5291ff58b8a0c7259286d38aecdae7f4 Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:09:33 -0700 Subject: [PATCH 20/30] Add solution to broken NVRAM on CML, macOS --- docs/installing-macos.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/installing-macos.md b/docs/installing-macos.md index 51f4d0ae..ed24ed9f 100644 --- a/docs/installing-macos.md +++ b/docs/installing-macos.md @@ -27,6 +27,11 @@ Before we begin, it's important to know whether your Chromebook is even supporte ### Known Issues - Broken NVRAM on Comet Lake Devices + - To fix this, **DISABLE** `DevirtualizeMimo`. + {: .warning} + If your device has a Comet Lake CPU, this MUST be disabled. + + - Waking from sleep causes: - Blank Electron / Chromium apps - Buggy video playback in web browsers like Firefox or Safari From e77eb0c7d299c01620bc07121e2514e6ffef9aa6 Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:13:39 -0700 Subject: [PATCH 21/30] Make some FAQ answers shorter --- docs/faq.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/faq.md b/docs/faq.md index 0b8f6978..ffa3142a 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -54,16 +54,16 @@ Please read this page before asking a question in the Discord. Your help request * No. One license per device. **I want to buy a Chromebook to run Windows or Linux or macOS -- which should I buy?** -* Buying any Chromebook with the intention of running macOS, Windows or Linux is not a great idea. Many can't boot anything other than ChromeOS; Those that can boot Linux (or Windows) often have functional deficiencies -- DO NOT EXPECT EVERYTHING TO WORK OUT OF THE BOX. Older models may fair better compatibility wise, but there are still lots of caveats, and it's not recommended to buy a Chromebook as a cheap Linux device. +* Buying any Chromebook with the intention of running macOS, Windows or Linux is not a great idea.s -- DO NOT EXPECT EVERYTHING TO WORK OUT OF THE BOX. Older models may fair better compatibility wise, but there are still lots of caveats, and it's not recommended to buy a Chromebook as a cheap Linux device. **How can I get audio working under Linux?** * Please see [here](https://github.com/WeirdTreeThing/chromebook-linux-audio) **I just want to boot Linux from USB on my Chromebook, what do I need to do?** -* Check the Supported Devices page, to ensure your device has functional RW_LEGACY firmware available. If so, then simply put your device into Developer Mode, then run my script and update the RW_LEGACY firmware (no need to disable the firmware write protect for this). Reboot, press CTRL+L to boot in Legacy Boot Mode/Alternative Bootloader Menu, then press ESC and select your USB from the boot menu. +* Check the Supported Devices page, to ensure your device has functional RW_LEGACY firmware available. If so, flash RWL and use that. **I just installed the UEFI firmware, and now my device boots to a black screen that says 'shell' - what do I do?** -* You're in the EFI shell; the firmware boots there when it can't find a valid UEFI boot device, either externally (USB, SD) or internally. Just type 'exit' to get back to the the UEFI settings menu, from which you can select your boot device or reboot. You need to install a UEFI-boot capable OS from a properly formatted USB/SD device. If you're creating the install media from Windows, use Rufus to write the ISO to USB. If writing a Windows ISO, select the ISO, then set the Partition scheme to 'MBR for UEFI' or 'GPT for UEFI;' 'MBR for UEFI-CSM' will not work since CSM = Legacy BIOS and the UEFI firmware doesn't support Legacy mode. For a Linux ISO, select the ISO, then change the write mode from 'ISO Image' to 'DD Image' from the drop-down menu. As most Linux ISO images these days are compatible with both Legacy and UEFI booting, this ensures maximum compatibility. +* You're in the EFI shell; the firmware boots there when it can't find a valid UEFI boot device, either externally (USB, SD) or internally. Just type 'exit' to get back to the the UEFI settings menu. **Should I install 32 or 64-bit OS?** * The UEFI Full ROM firmware only supports 64-bit OS, so be sure to use the 'x86_64' version of whatever OS you want to install. USB media created from 32-bit ISOs will simply fail to boot. From 77b0522843d87afa11e35e4257b7257f5e7f4a4d Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:27:05 -0700 Subject: [PATCH 22/30] Add Linux Support Table to supported-devices.md --- docs/supported-devices.md | 274 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 274 insertions(+) diff --git a/docs/supported-devices.md b/docs/supported-devices.md index f75b4090..0dd34efb 100644 --- a/docs/supported-devices.md +++ b/docs/supported-devices.md @@ -4,6 +4,11 @@ layout: default nav_order: 7 --- +### Table Of Contents: +1. [UEFI Support Table](#table-of-contents) +2. [Linux Support Table](#linux-support) + + ## Supported Devices and Platforms Supported devices are listed in the table below, grouped by platform/family, roughly in chronological order. To reiterate, support is determined entirely and exclusively by the Board Name. Device Names are just for reference, and may be incomplete as many models/sub-models may use the same Board Name. Figure out the Board Name and then locate it in the table. If it's not listed, it's not supported. @@ -3350,6 +3355,275 @@ If your device isn't listed, it doesn't have custom firmware support. -------------- +### Linux Support + +|Sandybridge/Ivybridge |Board Name |Supported? | Known Issues | +|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +|Device Name || | +|HP Pavilion Chromebook 14 |BUTTERFLY |Yes |- | +|Google Chromebook Pixel (2013) |LINK | | | +|Samsung Chromebook Series 5 550 |LUMPY | | | +|Acer C7/C710 Chromebook |PARROT | | | +|Lenovo Thinkpad X131e Chromebook |STOUT | | | +|Samsung Chromebox Series 3 |STUMPY | | | +| | | | | +|Haswell | | | | +|Device Name |Board Name |Supported?|Known issues | +|HP Chromebook 14 |FALCO |Yes |- | +|Toshiba Chromebook 13 (CB30) |LEON | | | +|Acer Chromebox CXI |McCLOUD | | | +|LG Chromebase 22 |MONROE | | | +|ASUS Chromebox CN60 |PANTHER | | | +|Acer C720/C720P Chromebook |PEPPY | | | +|Dell Chromebox 3010 |TRICKY | | | +|Dell Chromebook 11 (CB1C13) |WOLF | | | +|HP Chromebox CB1 / G1 |ZAKO | | | +| | | | | +|Broadwell | | | | +|Device Name |Board Name |Supported?|Known issues | +|Acer C740 Chromebook |AURON_PAINE|Yes |- | +|Acer C910 Chromebook (CB5-571) |AURON_YUNA | | | +|Acer Chromebase 24 |BUDDY | | | +|Toshiba Chromebook2 (2015) |GANDOF | | | +|ASUS Chromebox 2 (CN62) |GUADO | | | +|Dell Chromebook 13 7310 |LULU | | | +|Acer Chromebox CXI2 |RIKKU | | | +|Google Chromebook Pixel (2015) |SAMUS | | | +|Lenovo ThinkCentre Chromebox |TIDUS | | | +| | | | | +|Baytrail | | | | +|Device Name |Board Name |Supported?|Known issues | +|Acer Chromebook 15 (CB3-531) |BANJO |Yes |- | +|Dell Chromebook 11 (3120) |CANDY | | | +|Lenovo N20/N20P Chromebook |CLAPPER | | | +|Lenovo N21 Chromebook |ENGUARDE | | | +|Lenovo ThinkPad 11e/Yoga Chromebook |GLIMMER | | | +|Acer Chromebook 11 (CB3-111/131, C730, C730E, C735) |GNAWTY | | | +|Haier Chromebook G2 |HELI | | | +|HP Chromebook 11 G3/G4 HP Chromebook 14 G4 |KIP | | | +|AOpen Chromebox Commercial |NINJA | | | +|Lenovo Ideapad 100S Chromebook |ORCO | | | +|ASUS Chromebook C300 |QUAWKS | | | +|ASUS Chromebook C200 |SQUAWKS | | | +|AOpen Chromebase Commercial |SUMO | | | +|Toshiba Chromebook 2 (2014) |SWANKY | | | +|Samsung Chromebook 2 (XE500C12) |WINKY | | | +| | | | | +|Braswell | | | | +|Device Name |Board Name |Supported?|Known issues | +|Acer Chromebook 15 (CB3-532) |BANON |Yes |- | +|Samsung Chromebook 3 |CELES | | | +|Acer Chromebook R11 (C738T, CB5-132T) |CYAN | | | +|Acer Chromebook 14 (CB3-431) |EDGAR | | | +|Dell Chromebook 11 3180/3189 |KEFKA | | | +|Lenovo N22/N42 Chromebook |REKS | | | +|Acer Chromebook 11 N7 (C731) CTL NL61 Chromebook Edxis Education Chromebook (NL6D) HP Chromebook 11 G5 EE Mecer V2 Chromebook Positivo Chromebook C216B |RELM | | | +|HP Chromebook 11 G5 |SETZER | | | +|ASUS Chromebook C202S/C202SA |TERRA | | | +|ASUS Chromebook C300SA/C301SA |TERRA13 | | | +|Lenovo ThinkPad 11e/Yoga Chromebook (G3) |ULTIMA | | | +|CTL J5 Chromebook Edugear CMT Chromebook Haier Chromebook 11 C Multilaser Chromebook M11C PCMerge Chromebook PCM-116T-432B Prowise Chromebook Proline Viglen Chromebook 360 |WIZPIG | | | +| | | | | +|Skylake | | | | +|Device Name |Board Name |Supported?|Known issues | +|Dell Chromebook 13 3380 |ASUKA |Yes |max98357a doesn't have a volume limiter so speakers could get fried | +|Samsung Chromebook Pro |CAROLINE | | | +|ASUS Chromebook C302CA |CAVE | | | +|HP Chromebook 13 G1 |CHELL | | | +|Acer Chromebook 14 for Work Acer Chromebook 11 (C771/C771T) |LARS | | | +|Lenovo Thinkpad 13 Chromebook |SENTRY | | | +| | | | | +|Apollolake | | | | +|Device Name |Board Name |Supported?|Known issues | +|Acer Chromebook 11 (C732) |ASTRONAUT |Yes |MicroSD detection issues No headphone jack on SOF max98357a on AVS doesn't have a volume limiter so speakers could get fried | +|Asus Chromebook C223NA |BABYMEGA | | | +|ASUS Chromebook C523NA |BABYTIGER | | | +|CTL Chromebook NL7/NL7T Edxis Chromebook 11/X11 Positivo Chromebook N2110/N2112 Viglen Chromebook 360C |BLACKTIP | | | +|Acer Chromebook 15 (CB315) |BLUE | | | +|Acer Chromebook Spin 15 (CP315) |BRUCE | | | +|Acer Chromebook Spin 11 (R751T) |ELECTRO | | | +|Acer Chromebook 514 |EPAULETTE | | | +|Acer Chromebook Spin 11 CP311 |LAVA | | | +|Dell Chromebook 11 5190 |NASHER | | | +|Dell Chromebook 11 5190 2-in-1 |NASHER360 | | | +|Lenovo Thinkpad 11e/Yoga 11e (G4) |PYRO | | | +|ASUS Chromebook C423 |RABBID | | | +|ASUS Chromebook Flip C213SA |REEF | | | +|Lenovo 100e Chromebook |ROBO | | | +|Lenovo 500e Chromebook |ROBO360 | | | +|Acer Chromebook 15 (CB515-1HT) |SAND | | | +|Acer Chromebook 11 (CB311-8H) |SANTA | | | +|HP Chromebook x360 11 G1 EE HP Chromebook 11 G6 HP Chromebook 14 G5 |SNAPPY | | | +|CTL Chromebook J41/J41T PCmerge Chromebook AL116 Prowise Chromebook Eduline Sector 5 E3 Chromebook Viglen Chromebook 11C |WHITETIP | | | +| | | | | +|Kabylake / Amberlake | | | | +|Device Name |Board Name |Supported?|Known issues | +|Acer Chromebook 13 |AKALI |Yes |max98357a doesn't have a volume limiter so speakers could get fried | +|Acer Chromebook Spin 13 |AKALI360 | | | +|Google Pixelbook Go (2019) |ATLAS | |Cameras don't work | +|Acer Chromebook 715 (CB715) |BARD | |max98357a doesn't have a volume limiter so speakers could get fried | +|Acer Chromebook 714 (CB714) |EKKO | | | +|Google Pixelbook (2017) |EVE | | | +|AOpen Chromebox Commercial 2 Newline Chromebox A10 |JAX | | | +|Acer Chromebase 24I2 |KARMA | | | +|HP Chromebox G2 |KENCH | | | +|ASUS Chromebook C425 |LEONA | | | +|Samsung Chromebook Plus V2 |NAUTILUS | |Camera on the keyboard doesn't work | +|Google Pixel Slate |NOCTURNE | |Cameras don't work | +|Lenovo Yoga Chromebook C630 |PANTHEON | |max98357a doesn't have a volume limiter so speakers could get fried | +|ASUS Chromebook Flip C433/C434 |SHYVANA | | | +|Acer Chromebox CXI3 |SION | | | +|HP Chromebook x360 14 |SONA | | | +|HP Chromebook X2 |SORAKA | | | +|HP Chromebook 15 G1 |SYNDRA | | | +|ASUS Chromebox 3 (CN65) |TEEMO | | | +|Dell Inspiron Chromebook 14 (7460) |VAYNE | | | +|CTL Chromebox CBx1 Promethean Chromebox SMART Chromebox G3 ViewSonic NMP660 Chromebox |WUKONG | | | +| | | | | +|Geminilake | | | | +|Device Name |Board Name |Supported?|Known issues | +|ASUS Chromebook Flip C214/C234 |AMPTON |Yes |- | +|ASUS Chromebook Flip C204 |APEL | | | +|HP Chromebook x360 12b |BLOOG | | | +|HP Chromebook 14a |BLOOGLET | | | +|HP Chromebook x360 14a/14b |BLOOGUARD | | | +|Acer Chromebook 315 |BLORB | | | +|Samsung Chromebook 4 |BLUEBIRD | | | +|Acer Chromebook 311 (CB311-9H, CB311-9HT, C733, C733U, C733T) |BOBBA | | | +|Acer Chromebook Spin 311 (CP311-2H, CP311-2HN) Acer Chromebook Spin 511 (R752T, R752TN) |BOBBA360 | | | +|Samsung Chromebook 4+ |CASTA | | | +|NEC Chromebook Y2 |DOOD | | | +|HP Chromebook 14 G6 |DORP | | | +|Acer Chromebook 314 (CB314) Packard Bell Chromebook 314 (PCB314) |DROID | | | +|Dell Chromebook 3100 |FLEEX | | | +|CTL Chromebook VX11/VX11T Poin2 Chromebook 11P |FOOB | | | +|Poin2 Chromebook 11P |FOOB360 | | | +|ADVAN Chromebook 116 Axioo Chromebook Baicells Chromebook BB01 CTL Chromebook NL71/CT/LTE EVERCOSS Chromebook CB1 Edxis Chromebook 11 (S20-C) JOI Chromebook C100 Multilaser Chromebook M11C-PC914 Pixart Rxart Chromebook Poin2 Chromebook 11A SPC Chromebook X1 Mini Sector 5 E4 LTE Chromebook WS Chromebook A101 Zyrex Chromebook M432|GARG |Yes | | +|Ascon Chromebook 11A Axioo Chromebook 360 Baicells Chromebook BB01 CTL Chromebook NL71T/TW/TWB EVERCOSS Chromebook CB1A Edxis Chromebook 11 (S20-X) JOI Chromebook C100 Multilaser Chromebook M11HC-PC915 Pixart Rxart Chromebook Poin2 Chromebook 11A SPC Chromebook X1 Mini WS Chromebook A101 Zyrex Chromebook 360 |GARG360 |Yes | | +|CTL Chromebook NL81/NL81T |GARFOUR |Yes |- | +|Acer Chromebook 311 |GLK | | | +|Acer Chromebook Spin 311 |GLK360 | | | +|Dell Chromebook 3100 2-in-1 |GRABBITER | | | +|Lenovo Chromebook C340 |LASER | | | +|Lenovo Chromebook S340/IdeaPad 3 |LASER14 | | | +|Lenovo Ideapad 3 Chromebook |LICK | | | +|HP Chromebook x360 11 G2 EE |MEEP | | | +|HP Chromebook 11 G7 EE |MIMROCK | | | +|ASUS Chromebook C424 |NOSPIKE | | | +|Dell Chromebook 3400 |ORBATRIX | | | +|Lenovo 100e Chromebook 2nd Gen |PHASER | | | +|Lenovo 300e Chromebook 2nd Gen/IdeaPad Flex 3 NEC Chromebook Y1 |PHASER360 | | | +|Lenovo 500e Chromebook 2nd Gen |PHASER360S | | | +|Acer Chromebook 512 (C851/C851T) |SPARKY | | | +|Acer Chromebook Spin 512 (R851TN) |SPARKY360 | | | +|HP Chromebook 11 G8 EE |VORTICON | | | +|HP Chromebook x360 11 G3 EE |VORTININJA | | | +| | | | | +|Stoneyridge | | | | +|Device Name |Board Name |Supported?|Known issues | +|Acer Chromebook 315 (CB315-2H) |ALEENA |Yes |Needs kernel compiled with AMDGPU=Y instead of =M and firmware built-in to get working audio Broken S3 (sleep) on default coreboot build, needs a custom build for working sleep eMMC is only detected on a cold boot unless you have a patched kernel| +|HP Chromebook 11A G6 EE HP Chromebook 11A G8 EE |BARLA | | | +|HP Chromebook 14A G5 |CAREENA | | | +|Acer Chromebook 311 (C721) |KASUMI | | | +|Acer Chromebook Spin 311 (R721T) |KASUMI360 | | | +|Lenovo 14e Chromebook (S345) |LIARA | | | +|Lenovo 100e Chromebook 2nd Gen AMD |TREEYA | | | +|Lenovo 300e Chromebook 2nd Gen AMD |TREEYA360 | | | +| | | | | +|Whiskeylake | | | | +|Device Name |Board Name |Supported?|Known issues | +|Dell Latitude 5300 2-in-1 Chromebook Enterprise |ARCADA |? |? | +|Dell Latitude 5400 Chromebook Enterprise |SARIEN | | | +| | | | | +|Cometlake | | | | +|Device Name |Board Name |Supported?|Known issues | +|Lenovo Ideapad Flex 5 Chromebook |AKEMI |Yes |- | +|HP Chromebook x360 14c |DRAGONAIR | |Fingerprint reader doesn't work | +|Dell Latitude 7410 Chromebook Enterprise |DRALLION | |- | +|HP Pro c640 Chromebook |DRATINI | |Fingerprint reader doesn't work | +|ASUS Chromebox 4 |DUFFY | |- | +|ASUS Fanless Chromebox |FAFFY | | | +|ASUS Chromebook Flip C436FA |HELIOS | | | +|HP Elite c1030 Chromebook HP Chromebook x360 13c |JINLON | |Fingerprint reader doesn't work | +|Acer Chromebox CXI4 |KAISA | | | +|Acer Chromebook 712 (C871) |KINDRED | | | +|Acer Chromebook Spin 713 (CP713-2W) |KLED | | | +|Samsung Galaxy Chromebook |KOHAKU | |Fingerprint reader doesn't work Sleep issues related to EC (wakes up with lid closed) | +|Samsung Galaxy Chromebook 2 |NIGHTFURY | |- | +|HP Chromebox G3 |NOIBAT | | | +|CTL Chromebox CBx2 |WYVERN | | | +| | | | | +|Picasso/Dali | | | | +|Device Name |Board Name |Supported?|Known issues | +|HP Pro c645 Chromebook Enterprise |BERKNIP |Yes |Needs to add "iommu=pt" to cmdline eMMC models need to put /boot/efi and /boot on USB | +|HP Chromebook 14a |DIRINBOZ | | | +|Acer Chromebook Spin 514 |EZKINIL | | | +|HP Chromebook x360 14a |GUMBOZ | | | +|Lenovo ThinkPad C13 Yoga Chromebook |MORPHIUS | | | +|Lenovo Chromebook 100e Gen3 AMD |VILBOZ | | | +|Lenovo Chromebook 300e Gen3 AMD |VILBOZ360 | | | +|ASUS Chromebook Flip CM5 |WOOMAX | | | +| | | | | +|JasperLake | | | | +|Device Name |Board Name |Supported?|Known issues | +|Lenovo 3i-15 Chromebook |BLIPPER |Yes |Cameras untested. | +|Lenovo 500e Chromebook 3rd Gen |BOTEN | | | +|Samsung Galaxy Chromebook 2 360 |BUGZZY | | | +|Dell Chromebook 3110 |CRET | | | +|Dell Chromebook 3110 2-in-1 |CRET360 | | | +|HP Chromebook x360 11 G4 EE |DRAWCIA | | | +|HP Chromebook 11 G9 EE |DRAWLAT | | | +|HP Chromebook 14 G7 |DRAWMAN | | | +|ASUS Chromebook CX1500CKA |GALITH | | | +|ASUS Chromebook CX1700CKA |GALLOP | | | +|CTL Chromebook NL72 |KRACKO | | | +|HP Chromebook 14a |LANTIS | | | +|HP Chromebook x360 14b |MADOO | | | +|Acer Chromebook Spin 511 [R753T] |MAGOLOR | | | +|Acer Chromebook 317 [CB317-1H] |MAGPIE | | | +|NEC Chromebook Y3 |METAKNIGHT | | | +|Samsung Galaxy Chromebook Go |SASUKE | | | +|ASUS Chromebook CR1100CKA |STORO | | | +|ASUS Chromebook Flip CR1100FKA |STORO360 | | | +| | | | | +|TigerLake | | | | +|Device Name |Board Name |Supported?|Known issues | +|FMV Chromebook 14F |CHRONICLER |Yes |No fingerprint functionality (yet) on models that have it. USB4 troubleshooting in progress Workaround: rmmod cros-ec-typec;rmmod intel-pmc-mux; modprobe intel-pmc-mux;modprobe cros-ec-typec https://bugzilla.redhat.com/show_bug.cgi?id=2192574 | +|ASUS Chromebook Flip CX3 |COLLIS | | | +|ASUS Chromebook Flip CX5 (CX5400) |COPANO | | | +|ASUS Chromebook Flip CX55, CX5 (CX5500), C536 |DELBIN | | | +|ASUS Chromebook CX9400 |DROBIT | | | +|HP Chromebook x360 14c |ELDRID | | | +|HP Pro c640 G2 Chromebook |ELEMI | | | +|Lenovo IdeaPad Flex 5i Chromebook |LILLIPUP | | | +|Lenovo 5i-14 Chromebook Lenovo Slim 5 Chromebook |LINDAR | | | +|Acer Chromebook Spin 514 (CB514-2H) |VOEMA | | | +|Acer Chromebook 515 (CB515-1W, CB515-1WT) |VOLET | | | +|Acer Chromebook 514 (CB514-1W, CB514-1WT) |VOLTA | | | +|Acer Chromebook Spin 713 (CP713-3W) |VOXEL | | | +| | | | | +|AlderLake | | | | +|Device Name |Board Name |Supported?|Known issues | +|HP Elite c640 G3 Chromebook |ANAHERA |Yes |? | +|Framework Chromebook Edition |BANSHEE |Yes |No fingerprint functionality (yet) on models that have it. USB4 troubleshooting in progress Workaround: rmmod cros-ec-typec;rmmod intel-pmc-mux; modprobe intel-pmc-mux;modprobe cros-ec-typec https://bugzilla.redhat.com/show_bug.cgi?id=2192574 | +| | | | | +|Dell Latitude 5430 Chromebook |CROTA | | | +|Dell Latitude 5430 2-in-1 Chromebook |CROTA360 | | | +|ASUS Chromebook Flip CX5601 |FELWINTER | | | +|Acer Chromebook Entreprise Spin 714 (CP714-1WN) |KANO | | | +|ASUS Chromebook CX34 Flip ASUS Chromebook Vibe CX34 Flip |MITHRAX | | | +|Acer Chromebook 516 GE (CBG516-1H) |OSIRIS | | | +|Lenovo Thinkpad C14 Gen 1 |PRIMUS | | | +|HP Elite Dragonfly Chromebook |REDRIX | | | +|Lenovo Ideapad Flex 5i Chromebook |TAEKO | | | +|Lenovo Slim 5 Chromebook Lenovo IdeaPad 5i Chromebook |TARLO | | | +|Lenovo Ideapad Gaming Chromebook 16 |TANIKS | | | +|HP Elite Dragonfly Pro Chromebook |VELL | | | +|Acer Chromebook Vero 514 |VOLMAR | | | +|Acer Chromebook Vero 712 |ZAVALA | | | + + +
From 8e94f716274967d998a6e3ad9cf190a61701183d Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:37:14 -0700 Subject: [PATCH 23/30] Add USBC workaround for Linux, postinstall.md --- docs/post-install.md | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/docs/post-install.md b/docs/post-install.md index 29f27fac..fa91e7e4 100644 --- a/docs/post-install.md +++ b/docs/post-install.md @@ -8,8 +8,11 @@ nav_order: 16 ### Windows + +** Drivers and QOL improvements** * Compress the install with `compact.exe /compactos:always` in a Command Prompt with admin privileges if necessary. -* Install [CoolStar's drivers](https://coolstar.org/chromebook/windows-install.html) if you haven't already +* Install [CoolStar's drivers](https://coolstar.org/chromebook/windows-install.html) if you haven't already +* Buy audio drivers (if needed), see [the guide](csdriver.html) **CELES Post Install Workaround** @@ -22,10 +25,31 @@ nav_order: 16 ### Linux + +**General QOL Fixes** + * Run the [audio script](https://github.com/WeirdTreeThing/chromebook-linux-audio) if you haven't already. * Install [keyd](https://github.com/rvaiya/keyd) with the instructions in the README to remap top row FX keys. * Pick the relevant [keyboard layout](https://github.com/chrultrabook/keydconfig) and copy to `/etc/keyd/default.conf` +**Fixing USB C on TigerLake and AlderLake** +1. Create a file called `chromebook-usbc.service` file in `/etc/systemd/system/` +2. Paste the following contents into the file: + + ``` + [Unit] + Description=Enable USB-C on chromebook + + [Service] + Type=oneshot + RemainAfterExit=yes + ExecStartPre=/sbin/modprobe -r -a cros-ec-typec intel-pmc-mux + ExecStart=/sbin/modprobe -a intel-pmc-mux cros-ec-typec + + [Install] + WantedBy=multi-user.target + ``` +3. Enable the systemd service by typing `systemctl enable --now chromebook-usbc.service`, then reboot. ----------------------- @@ -33,7 +57,7 @@ nav_order: 16 ### macOS * [Remove Verbose](https://dortania.github.io/OpenCore-Post-Install/cosmetic/verbose.html#macos-decluttering) * [OpenCore GUI](https://dortania.github.io/OpenCore-Post-Install/cosmetic/gui.html#setting-up-opencore-s-gui) -* [Setup Emulated NVRAM](https://dortania.github.io/OpenCore-Post-Install/misc/nvram.html) if necessary. +* Disable `DevirtualizeMimo` if you're on CML (CometLake, 10th generation)
From a22849c361ebc9303056089c122a4fe6cbfca1dd Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:38:50 -0700 Subject: [PATCH 24/30] Flashing Custom Firmware -> Step 2, include SuzyQ CCD as one of the possible methods --- docs/firmware.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/firmware.md b/docs/firmware.md index 7cae3179..760adcfc 100644 --- a/docs/firmware.md +++ b/docs/firmware.md @@ -37,6 +37,7 @@ To convert your machine from Google's firmware and chromeOS to Coreboot and AltO * Undo a WP screw * Unplug your battery * Bridge two jumpers + * Plug in a SuzyQable 3. Run [MrChromebox's firmware utility script.](https://mrchromebox.tech/#fwscript) * Type `cd; curl -LO mrchromebox.tech/firmware-util.sh && sudo bash firmware-util.sh` and press Enter. From 56674e3e9b4e40fa3ae4af5e31afc545b7dc37e9 Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:43:09 -0700 Subject: [PATCH 25/30] Make updating coreboot instructions easier to understand --- docs/firmware.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/firmware.md b/docs/firmware.md index 760adcfc..bba4ce13 100644 --- a/docs/firmware.md +++ b/docs/firmware.md @@ -50,15 +50,19 @@ To convert your machine from Google's firmware and chromeOS to Coreboot and AltO **Updating coreboot** -1. Boot a Linux live USB (Ubuntu 22.04 recommended) +1. Boot a live Linux USB. See [here](bootableusb.html) for a guide on making a bootable USB. {: .note } curl is not installed by default for Ubuntu / Ubuntu distros. To install it, run: `sudo apt update;sudo apt install curl -y` -2. Run the same firmware utility script you used to install coreboot +2. Once you have booted the live USB, **do not install the OS. Some distros may have the option to "try now" click that.** + +3. Connect to the internet. Then open a terminal. + +4. Run the same firmware utility script you used to install coreboot * In case you forgot, type `cd; curl -LO mrchromebox.tech/firmware-util.sh && sudo bash firmware-util.sh` and press Enter. -3. Pick option 1; "Install/Update UEFI (Full ROM) Firmware" and reboot if successful +5. Pick option 1; "Install/Update UEFI (Full ROM) Firmware" and reboot if successful ------- From 979f80b785ed842d1264edbcc0c58f6d3053cee1 Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:44:43 -0700 Subject: [PATCH 26/30] altOS -> Windows, specify that drivers are paid for SKL and newer only --- docs/altos.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/altos.md b/docs/altos.md index 46f59298..b3bf520e 100644 --- a/docs/altos.md +++ b/docs/altos.md @@ -17,8 +17,8 @@ Pros: * Better game support Cons: -* Audio driver is paid (10 USD) -* Thunderbolt driver is paid (20 USD) +* Audio driver is paid (10 USD) for Skylake (6th generation) and newer devices +* Thunderbolt driver is paid (20 USD) for certain generations * Requires the user to install many drivers * AVS and SOF users experience instability at times From dee2c92a32a1c4f5b06a386aa45ce96ac8e0bef3 Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:45:57 -0700 Subject: [PATCH 27/30] Add SOF/AVS sleep wake crash to known issues --- docs/known-issues.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/known-issues.md b/docs/known-issues.md index 60dbe003..7d1fc0e9 100644 --- a/docs/known-issues.md +++ b/docs/known-issues.md @@ -40,6 +40,7 @@ You should avoid buying any devices in this list. * No fingerprint reader support * No TPM support * No IPU camera support +* OS will BSOD with AVS/SOF driver installer when transitioning from sleep ### Linux From 390ec6f6f76ebbcde9e30de60fc886ecf711715d Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:46:59 -0700 Subject: [PATCH 28/30] Note that PopOS and Debian 12 need custom kernel --- docs/known-issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/known-issues.md b/docs/known-issues.md index 7d1fc0e9..31775ee0 100644 --- a/docs/known-issues.md +++ b/docs/known-issues.md @@ -45,10 +45,10 @@ You should avoid buying any devices in this list. ### Linux -* Broken USB-C on TigerLake and AlderLake (although there is a workaround) +* Broken USB-C on TigerLake and AlderLake. See Post Install -> Linux for fix. * No fingerprint reader support * Sandybridge/Ivybridge need a [workaround](https://github.com/MrChromebox/scripts/issues/277) to flash firmware from linux. - +* PopOS and Debian 12 Bookworm need a custom kernel ### macOS From 65fc425922e1536f49f85bcfa0006004b6863c9e Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:50:04 -0700 Subject: [PATCH 29/30] Make spellbot complain less Makes spellbot not comment on PRs, hopefully --- .github/workflows/spelling.yml | 38 ---------------------------------- 1 file changed, 38 deletions(-) diff --git a/.github/workflows/spelling.yml b/.github/workflows/spelling.yml index 0dbbbe16..94a41c15 100644 --- a/.github/workflows/spelling.yml +++ b/.github/workflows/spelling.yml @@ -66,42 +66,4 @@ jobs: spell_check_this: check-spelling/spell-check-this@prerelease task: ${{ needs.spelling.outputs.followup }} - comment-pr: - name: Report (PR) - # If you workflow isn't running on pull_request*, you can remove this job - runs-on: ubuntu-latest - needs: spelling - permissions: - pull-requests: write - if: (success() || failure()) && needs.spelling.outputs.followup && contains(github.event_name, 'pull_request') - steps: - - name: comment - uses: check-spelling/check-spelling@main - with: - checkout: true - spell_check_this: check-spelling/spell-check-this@prerelease - task: ${{ needs.spelling.outputs.followup }} - experimental_apply_changes_via_bot: 1 - update: - name: Update PR - permissions: - contents: write - pull-requests: write - actions: read - runs-on: ubuntu-latest - if: ${{ - github.event_name == 'issue_comment' && - github.event.issue.pull_request && - contains(github.event.comment.body, '@check-spelling-bot apply') - }} - concurrency: - group: spelling-update-${{ github.event.issue.number }} - cancel-in-progress: false - steps: - - name: apply spelling updates - uses: check-spelling/check-spelling@main - with: - experimental_apply_changes_via_bot: 1 - checkout: true - ssh_key: "${{ secrets.CHECK_SPELLING }}" From 599ce0dd8382eb76c87d180dfdc37f3a021621d2 Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 25 Aug 2023 21:51:58 -0700 Subject: [PATCH 30/30] Make spellbot shut up (2) --- .github/actions/spelling/allow.txt | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/.github/actions/spelling/allow.txt b/.github/actions/spelling/allow.txt index a60c96a9..68b1569b 100644 --- a/.github/actions/spelling/allow.txt +++ b/.github/actions/spelling/allow.txt @@ -578,3 +578,32 @@ GPIO meghann Ximimark Yourfilename +AMDGPU +ASUS +autofanctrl +bootableusb +BSOD +bugzilla +cgi +choie +cmdline +crosec +Devirtualize +driverinstallers +instructionaly +iommu +Mimo +newner +oneshot +overclock +pmc +QOL +redhat +rmmod +sbin +systemctl +systemd +TARLO +typec +usbc +USBs