diff --git a/.github/actions/spelling/allow.txt b/.github/actions/spelling/allow.txt index 68b1569b..a60c96a9 100644 --- a/.github/actions/spelling/allow.txt +++ b/.github/actions/spelling/allow.txt @@ -578,32 +578,3 @@ 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 diff --git a/.github/workflows/spelling.yml b/.github/workflows/spelling.yml index ce7e2a57..33abcaf2 100644 --- a/.github/workflows/spelling.yml +++ b/.github/workflows/spelling.yml @@ -64,4 +64,7 @@ jobs: with: checkout: true spell_check_this: check-spelling/spell-check-this@prerelease - task: ${{ needs.spelling.outputs.followup }} \ No newline at end of file + task: ${{ needs.spelling.outputs.followup }} + +# Removed PR portions to make bot shut the hell up +# - meghan6 diff --git a/docs/advanced.md b/docs/advanced.md deleted file mode 100644 index eaef6b2e..00000000 --- a/docs/advanced.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -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 😉. diff --git a/docs/allaboutfirmware.md b/docs/allaboutfirmware.md index 373276d5..1f5e7f06 100644 --- a/docs/allaboutfirmware.md +++ b/docs/allaboutfirmware.md @@ -7,15 +7,6 @@ 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 ---------------------- diff --git a/docs/altos.md b/docs/altos.md index b3bf520e..46f59298 100644 --- a/docs/altos.md +++ b/docs/altos.md @@ -17,8 +17,8 @@ Pros: * Better game support Cons: -* Audio driver is paid (10 USD) for Skylake (6th generation) and newer devices -* Thunderbolt driver is paid (20 USD) for certain generations +* Audio driver is paid (10 USD) +* Thunderbolt driver is paid (20 USD) * Requires the user to install many drivers * AVS and SOF users experience instability at times diff --git a/docs/bootableusb.md b/docs/bootableusb.md deleted file mode 100644 index 3f708b5c..00000000 --- a/docs/bootableusb.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -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 diff --git a/docs/compiling-coreboot.md b/docs/compiling-coreboot.md index 8c647b00..77ec176e 100644 --- a/docs/compiling-coreboot.md +++ b/docs/compiling-coreboot.md @@ -2,7 +2,6 @@ title: Compiling Custom Firmware layout: default nav_order: 18 -parent: Advanced --- ### Cloning & Building ROMs diff --git a/docs/debugging.md b/docs/debugging.md index ed65a1ba..83d45f78 100644 --- a/docs/debugging.md +++ b/docs/debugging.md @@ -2,7 +2,6 @@ title: Debugging layout: default nav_order: 17 -parent: Advanced --- ## Debugging @@ -11,15 +10,6 @@ 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: diff --git a/docs/distros.md b/docs/distros.md index e3cf68ba..e4ceeef6 100644 --- a/docs/distros.md +++ b/docs/distros.md @@ -2,7 +2,6 @@ title: Distro Specific Configuration layout: default nav_order: 23 -parent: Advanced --- diff --git a/docs/faq.md b/docs/faq.md index ffa3142a..0b8f6978 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.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. +* 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. **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, flash RWL and use that. +* 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. **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. +* 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. **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. diff --git a/docs/firmware.md b/docs/firmware.md index bba4ce13..93af4f6b 100644 --- a/docs/firmware.md +++ b/docs/firmware.md @@ -4,14 +4,6 @@ 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. @@ -37,7 +29,6 @@ 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. @@ -50,19 +41,15 @@ To convert your machine from Google's firmware and chromeOS to Coreboot and AltO **Updating coreboot** -1. Boot a live Linux USB. See [here](bootableusb.html) for a guide on making a bootable USB. +1. Boot a Linux live USB (Ubuntu 22.04 recommended) {: .note } curl is not installed by default for Ubuntu / Ubuntu distros. To install it, run: `sudo apt update;sudo apt install curl -y` -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 +2. 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. -5. Pick option 1; "Install/Update UEFI (Full ROM) Firmware" and reboot if successful +3. Pick option 1; "Install/Update UEFI (Full ROM) Firmware" and reboot if successful ------- diff --git a/docs/getting-started.md b/docs/getting-started.md index 5e258911..49dadbf8 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -5,14 +5,7 @@ nav_order: 4 --- ## Getting Started - -### Terminology - -| **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) | +Before we begin, we need to go over a few things. ------------- @@ -52,6 +45,14 @@ 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. -------------- diff --git a/docs/installing-linux.md b/docs/installing-linux.md index 04bcb5f8..4569f1f0 100644 --- a/docs/installing-linux.md +++ b/docs/installing-linux.md @@ -17,11 +17,12 @@ 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 August 2023 (in no particular order) are:** +**Recommended distros as of June 2023 (in no particular order) are:** * Arch Linux * Fedora * OpenSUSE Tumbleweed +* Pop!_OS * Debian 12 (Bookworm) ---------------- @@ -29,9 +30,9 @@ Ubuntu and Ubuntu-based distributions, such as Mint or ElementaryOS are unsuppor ### Installation: -1. Create a bootable Linux USB. See [here](bootableusb.html) for a guide. +1. Create a bootable Linux USB. Ubuntu and Ubuntu based distros have outdated packages and thus are not supported. 2. Plug the USB Drive into the Chromebook. -3. Turn on the Chromebook, press `ESC` at the POST screen (when the boot logo appears), and select your USB to boot from. +3. Turn on the Chromebook, press `ESC` at the POST screen, and select the USB to boot from. 4. Install as you would on any other computer. @@ -43,17 +44,9 @@ 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 +
-**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) +1. Run WeirdTreeThing's [audio script.](https://github.com/WeirdTreeThing/chromebook-linux-audio) {: .fs-5 } diff --git a/docs/installing-macos.md b/docs/installing-macos.md index ed24ed9f..51f4d0ae 100644 --- a/docs/installing-macos.md +++ b/docs/installing-macos.md @@ -27,11 +27,6 @@ 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 diff --git a/docs/known-issues.md b/docs/known-issues.md index 31775ee0..60dbe003 100644 --- a/docs/known-issues.md +++ b/docs/known-issues.md @@ -40,15 +40,14 @@ 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 -* Broken USB-C on TigerLake and AlderLake. See Post Install -> Linux for fix. +* Broken USB-C on TigerLake and AlderLake (although there is a workaround) * 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 diff --git a/docs/post-install.md b/docs/post-install.md index fa91e7e4..29f27fac 100644 --- a/docs/post-install.md +++ b/docs/post-install.md @@ -8,11 +8,8 @@ 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 -* Buy audio drivers (if needed), see [the guide](csdriver.html) +* Install [CoolStar's drivers](https://coolstar.org/chromebook/windows-install.html) if you haven't already **CELES Post Install Workaround** @@ -25,31 +22,10 @@ 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. ----------------------- @@ -57,7 +33,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) -* Disable `DevirtualizeMimo` if you're on CML (CometLake, 10th generation) +* [Setup Emulated NVRAM](https://dortania.github.io/OpenCore-Post-Install/misc/nvram.html) if necessary.
diff --git a/docs/supported-devices.md b/docs/supported-devices.md index 0dd34efb..c77e629e 100644 --- a/docs/supported-devices.md +++ b/docs/supported-devices.md @@ -4,11 +4,6 @@ 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. @@ -112,7 +107,7 @@ If your device isn't listed, it doesn't have custom firmware support. - ✅ + ✅ [1] jumper @@ -569,7 +564,7 @@ If your device isn't listed, it doesn't have custom firmware support. EOL - ✅ + ✅ [2] screw @@ -1904,7 +1899,7 @@ If your device isn't listed, it doesn't have custom firmware support. ALEENA - ✅ + ✅ [3] ✅ @@ -1917,7 +1912,7 @@ If your device isn't listed, it doesn't have custom firmware support. BARLA - ✅ + ✅ [3] ✅ @@ -1930,7 +1925,7 @@ If your device isn't listed, it doesn't have custom firmware support. CAREENA - ✅ + ✅ [3] ✅ @@ -1943,7 +1938,7 @@ If your device isn't listed, it doesn't have custom firmware support. KASUMI - ✅ + ✅ [3] ✅ @@ -1956,7 +1951,7 @@ If your device isn't listed, it doesn't have custom firmware support. KASUMI360 - ✅ + ✅ [3] ✅ @@ -1969,7 +1964,7 @@ If your device isn't listed, it doesn't have custom firmware support. LIARA - ✅ + ✅ [3] ✅ @@ -1982,7 +1977,7 @@ If your device isn't listed, it doesn't have custom firmware support. TREEYA - ✅ + ✅ [3] ✅ @@ -1995,7 +1990,7 @@ If your device isn't listed, it doesn't have custom firmware support. TREEYA360 - ✅ + ✅ [3] ✅ @@ -3355,275 +3350,6 @@ 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 | | | - - -