From 8dcb355e503f7792262cef402c9d388445e536de Mon Sep 17 00:00:00 2001 From: sadlerm4 Date: Wed, 17 Jul 2024 13:49:36 +0800 Subject: [PATCH 1/5] faq.md: reorganize and remove duplicate questions --- src/docs/faq.md | 63 +++++++++++++++++++++++-------------------------- 1 file changed, 29 insertions(+), 34 deletions(-) diff --git a/src/docs/faq.md b/src/docs/faq.md index ff2e9f9c..d6c33ba9 100644 --- a/src/docs/faq.md +++ b/src/docs/faq.md @@ -4,52 +4,43 @@ Please read this page before asking for help. Your help request will be pointed to the docs otherwise. ::: +::: tip +For questions related to MrChromebox firmware, please visit [https://docs.mrchromebox.tech/docs/faq.html] +::: + ## General questions ### What OS should I use? - This depends on your use case. Only you can answer this question. -### Should I use rw-legacy or full rom? +### Why is your supported devices list different to MrChromebox's list? -- This depends on what you are looking to use your device for. If you are planning on installing Windows or macOS you need to use full rom. Rw-legacy only supports linux. +- MrChromebox only provides firmware support. A device having firmware available does not mean that it has Windows/Linux/macOS support. If your device has firmware support but no OS support, open a post on the [Chrultrabook Forum](https://forum.chrultrabook.com) and someone will try to help. -### My internal keyboard doesn't work, can I use an external keyboard to get into developer mode? +### Should I use RW_LEGACY or Full ROM MrChromebox firmware? -- No. The hotkeys will only work on the internal keyboard. Chromeboxes do not have this restriction. +- This depends on what you are looking to use your device for. If you are planning on installing Windows or macOS you need to use full ROM. RW_LEGACY only supports Linux. -### I just want to boot Linux from USB on my Chromebook, what do I need to do? +### My internal keyboard doesn't work, can I use an external keyboard to enable Developer Mode? -- Check the Supported Devices page, to ensure your device has functional RW_LEGACY firmware available. If so, flash RWL (RW_LEGACY firmware) and use that. +- No. The hotkeys will only work on the internal keyboard. Chromeboxes do not have this restriction. -### Can I disable power-on when I open my Chromebook? +### Can I disable auto power-on when I open my Chromebook lid? - No. In what situation would you open your Chromebook without the intention of turning it on anyways. ### My Chromebook powers back on when I turn it off. How can I fix this? -- You Do not. Specific Chromebooks have this bug which takes too much effort to debug. If you were looking to disable power-on when you open the lid because of this, they are completely unrelated. - -### I just installed the UEFI firmware, and now my device boots to a black screen that says 'shell' - what do I do? - -- you are 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. +- It's a known issue. Specific Chromebooks have this bug which takes too much effort to debug. If you were looking to disable power-on when you open the lid because of this, they are two completely unrelated things. ### 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. - -### I'm running Legacy boot firmware now - can I switch to the UEFI firmware? - -- If you are using SeaBIOS, you will likely need to re-install your operating system. Otherwise it should work fine. - -### Help! I can't exit Developer Mode - -- If you are trying to exit Developer Mode but get the error `WARNING: TONORM prohibited by GBB_FORCE_DEV_SWITCH_ON` or find the `Return to secure mode` button missing, you need to reset your GBB flags. You can do that by running [MrChromebox's firmware utility script](https://mrchromebox.tech/#fwscript) and selecting `3) Set Boot Options (GBB flags)`, followed by `5) Reset to factory default`. - - Then exit developer mode by choosing "Return to secure mode" on the bootup screen +- The UEFI Full ROM firmware only supports 64-bit OSes, so be sure to use the 'x86_64' or 'amd64' version of whatever OS you want to install. USB media created from 32-bit ISOs will simply fail to boot. ### Can I modify the fan speed? -- Yes, using ectool. To set the fan to auto, run: `ectool autofanctrl`. To specify a percentage, run `ectool fanduty [0-100]`. +- Yes, using ectool. To set the fan to auto, run: `ectool autofanctrl`. To specify a percentage, run `ectool fanduty [0-100]`. You can find more info about ectool [here](). ### Can I overclock the fan? @@ -57,7 +48,11 @@ Please read this page before asking for help. Your help request will be pointed ### I want to buy a Chromebook to run Windows or Linux or macOS -- which should I buy? -- Any 64 bit Chromebook should work in Windows and Linux. Some require paid drivers (Windows only). For information on macOS requirements, see [this page](installing/installing-macos.md). +- Any 64-bit Chromebook up to Intel Core 13th gen (Raptor Lake) should work in Windows and Linux. We appreciate the community helping to test hardware, and your patience if not everything works immediately the way you expected it to. Some Chromebooks require paid audio drivers (Windows only). For information on macOS requirements, see [this page](installing/installing-macos.md). + +### Are there any Chromebooks/Chromeboxes I should avoid buying/converting to a chrultrabook? + +- Please check [https://docs.mrchromebox.tech/known-issues.html] for a list of firmware issues that affect some platforms. Then check any device-specific notes section in the [supported devices list](/firmware/supported-devices.html)
@@ -65,19 +60,19 @@ Please read this page before asking for help. Your help request will be pointed ### Should I use Windows 10 or 11? -- Windows 11 is required for TB4 users. If you Do not have Thunderbolt 4, you may use both 10 or 11. +- Windows 11 is required for TB4 users. If you do not have Thunderbolt 4, you may use either 10 or 11. ### Can I pay for Windows drivers using PayPal? - You can pay via PayPal in Patreon. -### My balance shows zero on coolstars portal, what should I do? +### How do I buy/download/install the Windows audio/Thunderbolt drivers after I've subscribed on Patreon? -- It may take up to 48 hours for balance to appear in her portal, though it is normally less then 2. +- After logging into [CoolStar's driver portal](https://coolstar.org/chromebook/driverlicense/login.html) with your Patreon account, follow the instructions onscreen for a step by step tutorial. -### How do I buy the Windows audio/Thunderbolt drivers? +### My balance shows zero on CoolStar's portal, what should I do? -- Please see [CoolStar's driver portal](https://coolstar.org/chromebook/driverlicense/login.html) for a step by step tutorial on purchasing drivers. +- It may take up to 48 hours for the balance to be updated on the portal, though it is normally less than 2. ### Can I get AVS or SOF drivers for free? @@ -85,13 +80,13 @@ Please read this page before asking for help. Your help request will be pointed ### Why is there a license error in Device Manager after installing audio drivers? -- You messed up the license setup. Please refer to [CoolStar's driver portal](https://coolstar.org/chromebook/driverlicense/login.html). +- You messed up the license setup. Please refer to instructions on CoolStar's portal and the README contained within the files you downloaded when downloading the driver. ### Will the audio driver still work when re-installing Windows? - Yes, on the device the license was created. If the internal drive was replaced, see below. -### I upgraded my Chromebooks' internal drive and my audio/Thunderbolt 4 license is not working, what do I do? +### I upgraded my Chromebook's internal drive and my audio/Thunderbolt 4 license is not working, what do I do? - The license is tied to the serial number of your internal drive. **You do not need to buy another license**. Send CoolStar a message through Patreon, and wait for about a week. @@ -113,11 +108,11 @@ Please read this page before asking for help. Your help request will be pointed - They have started to force snap on their users. - They have published an LTS distro with a non-LTS kernel. -Becuse of these things, Ubuntu is unsupported. We will not help you fix issues on Ubuntu. +Becuse of these things, and the time and effort that would be required for the project to work around them, Ubuntu is unsupported. We will not help you fix issues on Ubuntu. -### What Linux distros are recommended? +### What Linux distros are recommended by the chrultrabook project? -- See [this page](installing/installing-linux.md). +- Fedora, Ultramarine Linux, Arch Linux and Debian. ### How can I get audio working under Linux? From de9bb5f07ee2c7ba7a94653afd357b313d7bfe45 Mon Sep 17 00:00:00 2001 From: sadlerm4 Date: Mon, 22 Jul 2024 04:36:04 +0800 Subject: [PATCH 2/5] index.md: add title and remove separator before h2 --- src/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/index.md b/src/index.md index 21221cc2..d79b5973 100644 --- a/src/index.md +++ b/src/index.md @@ -1,5 +1,6 @@ --- home: true +title: Home heroText: Welcome to the Chrultrabook Docs tagline: Convert your Chromebook into an Ultrabook! heroImage: /chrome.svg @@ -18,8 +19,6 @@ footer: A chrultrabook is a modified Chromebook that is able to run Windows, Linux, and sometimes macOS by using MrChromebox’s coreboot firmware. The purpose of this site is to provide documentation that is detailed, user-friendly, and has up-to-date information about the hardware, software, and firmware on Chromebooks. ---- - ## These docs focus on two main things - Installing Windows/Linux/macOS on your Chromebook. From bc752a6782d583adff00e94d0e2ec53ee0f42cab Mon Sep 17 00:00:00 2001 From: sadlerm4 Date: Mon, 22 Jul 2024 20:00:57 +0800 Subject: [PATCH 3/5] ventoy.md: simplify title, reminder to enable developer mode --- src/docs/firmware/ventoy.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/src/docs/firmware/ventoy.md b/src/docs/firmware/ventoy.md index 495cddcb..8ff7d287 100644 --- a/src/docs/firmware/ventoy.md +++ b/src/docs/firmware/ventoy.md @@ -1,6 +1,6 @@ -# Installing Ventoy to a USB drive with chromeOS +# Using Ventoy on ChromeOS -Ventoy is a useful tool that allows you to have multiple OS installer images on a single drive. It is also the only way to properly create an installer for Windows using chromeOS. +Ventoy is a useful tool that allows you to have multiple OS installer images on a single drive. It is also the only way to properly create the Windows installer using ChromeOS. ## Backing up your drive @@ -16,6 +16,10 @@ Grab the latest Ventoy release from [GitHub](https://github.com/ventoy/Ventoy/re ## Extracting Ventoy +::: tip NOTE +You need to have already enabled Developer Mode first. +::: + Open VT-2 by pressing Ctrl + Alt + 🡢 (F2) and run the following commands as root: 1. `cd /usr/local` @@ -36,7 +40,7 @@ Run the following command to start the Ventoy Web GUI: - `./VentoyWeb.sh` -Next, switch back to VT-1 by pressing Ctrl + Alt + 🡠 (F1)and open `http://localhost:24680` in Chrome. +Next, switch back to VT-1 by pressing Ctrl + Alt + 🡠 (F1) and open `http://localhost:24680` in Chrome. You should see this on your screen now: From 2695c5f27d6bdf2a15801d6d9ba676c2c751435b Mon Sep 17 00:00:00 2001 From: sadlerm4 Date: Mon, 22 Jul 2024 20:15:42 +0800 Subject: [PATCH 4/5] Move firmware/ventoy.md to installing/ventoy.md --- src/.vuepress/config.js | 10 ++++++---- src/docs/{firmware => installing}/ventoy.md | 0 2 files changed, 6 insertions(+), 4 deletions(-) rename src/docs/{firmware => installing}/ventoy.md (100%) diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js index 520c2792..a2e65922 100644 --- a/src/.vuepress/config.js +++ b/src/.vuepress/config.js @@ -120,10 +120,6 @@ export default { { text: 'Flashing Manually', link: '/docs/firmware/manually-flashing', - }, - { - text: 'Installing Ventoy With chromeOS', - link: '/docs/firmware/ventoy' } ] }, @@ -139,6 +135,12 @@ export default { { text: 'Creating a Bootable USB', link: '/docs/installing/bootableusb', + collapsible: true, + children: [ + { + text: 'Using Ventoy on ChromeOS', + link: '/docs/installing/ventoy' + } }, { text: 'Installing Windows', diff --git a/src/docs/firmware/ventoy.md b/src/docs/installing/ventoy.md similarity index 100% rename from src/docs/firmware/ventoy.md rename to src/docs/installing/ventoy.md From 0a2ce6500502d1293ce25711926ede5bd59b1698 Mon Sep 17 00:00:00 2001 From: sadlerm4 Date: Mon, 22 Jul 2024 20:18:48 +0800 Subject: [PATCH 5/5] config.js: fix json --- src/.vuepress/config.js | 1 + 1 file changed, 1 insertion(+) diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js index a2e65922..0c6dffbe 100644 --- a/src/.vuepress/config.js +++ b/src/.vuepress/config.js @@ -141,6 +141,7 @@ export default { text: 'Using Ventoy on ChromeOS', link: '/docs/installing/ventoy' } + ] }, { text: 'Installing Windows',